一、全局异常 通过 <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);
}