.NET 9.0 的 Blazor Web App 项目,Bootstrap Blazor 全局异常 <ErrorLogger> 使用备忘

一、全局异常 通过 <ErrorLogger> 组件实现,可以对全局的日志、异常进行统一输出,该组件【已经包含】在 <BootstrapBlazorRoot> 中,使用了 <BootstrapBlazorRoot> 组件包裹的 razor组件 【不用】再额外添加 <ErrorLogger> 组件包裹。

二、全局异常 默认已经开启、后台自动生效,【不用】在项目中做其他任务额外操作,项目发布后执行时,自动拦截异常,项目不会因为发生异常而崩溃、导致不可用,可能会在页面顶端显示 全局异常 的简要说明,如下图所示。

三、如果要显示 全局异常 的详细说明,可以在 appsettings.json 中进行配置。注意,此配置在 "BootstrapBlazorOptions" 外面。

cs 复制代码
............

  //BB全局异常:是否输出详细错误信息
  "DetailedErrors": true,

............

  "BootstrapBlazorOptions": {
    "ToastDelay": 5000,
    "MessageDelay": 5000,
    "SwalDelay": 5000,

    //BB全局异常:不配置时,默认值为 true = 启用;false 禁用
    "EnableErrorLogger": true,

............

  }

四、如果要关闭默认开启的 全局异常,可以 "BootstrapBlazorOptions" 中进行配置。关闭后,发现 全局异常 时,页面崩溃,显示如下图所示提示。

五、如果要将 全局异常 信息记录到日志文件中、方便事后查阅,操作步骤如下。

  1. 通过【NuGet 包管理器】引用 Longbow.Logging 组件包。

  2. 在 Program.cs 中注册服务。注册后,全局异常 发生后,自动写入日志文件中,日志文件默认位于项目执行文件所在目录中的 Logs 子目录中。日志目录、文件名可以在注册时进行修改,如下示例代码中所示。

cs 复制代码
............

/* 全局异常(自动记录,也可以手动记录,例如 Logger.LogInformation 等)日志记录:先要清除默认的日志提供程序 */
builder.Logging.ClearProviders();  
builder.Services.AddLogging(builder => builder.AddFileLogger());
//builder.Services.AddLogging(builder => builder.AddFileLogger(options => { options.FileName = "LogsAbc\\Abc.log"; }));

............
  1. 也可以手动记录日志到日志文件中,示例代码如下所示。
cs 复制代码
    @inject ILogger<Counter> Logger
    private void IncrementCount()
    {
        currentCount++;
        Logger.LogInformation("Counter incremented to {Count}", currentCount);
    }
相关推荐
唐青枫3 小时前
C#.NET dapper 详解
c#·.net
灵感__idea3 小时前
JavaScript高级程序设计(第5版):好的编程就是掌控感
前端·javascript·程序员
烛阴4 小时前
Mix
前端·webgl
代码续发5 小时前
前端组件梳理
前端
试图让你心动5 小时前
原生input添加删除图标类似vue里面移入显示删除[jquery]
前端·vue.js·jquery
死也不注释6 小时前
【鸡零狗碎记录】
unity·c#
陈不知代码6 小时前
uniapp创建vue3+ts+pinia+sass项目
前端·uni-app·sass
小王码农记6 小时前
sass中@mixin与 @include
前端·sass
Maybe_ch6 小时前
.NET-键控服务依赖注入
开发语言·c#·.net
陈琦鹏6 小时前
轻松管理 WebSocket 连接!easy-websocket-client
前端·vue.js·websocket