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

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

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

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

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

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

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

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

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

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

  }

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

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

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

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

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

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

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

3. 也可以手动记录日志到日志文件中,示例代码如下所示。

    @inject ILogger<Counter> Logger
    private void IncrementCount()
    {
        currentCount++;
        Logger.LogInformation("Counter incremented to {Count}", currentCount);
    }

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值