Dijing.SerilogExt 1.2.9

Dijing.SerilogExt

基于 Serilog 的日志配置封装，一行代码完成控制台、文件、Seq 与内存四路输出，并提供日志事件用于重定向到 UI。

安装

Install-Package Dijing.SerilogExt

或

dotnet add package Dijing.SerilogExt

目标框架 netstandard2.0，可直接用于 .NET Framework 4.6.1+ 与 .NET 6/8/9/10。

快速开始

using Dijing.SerilogExt;
using Serilog;

// 初始化（建议在程序入口调用一次）
InitLog.SetLog(RunModeEnum.Debug, path: "logs");

Log.Information("程序启动 {Time}", DateTime.Now);
Log.Warning("磁盘剩余空间 {Free} MB", 1024);

// 退出前刷新缓冲
Log.CloseAndFlush();

初始化后直接使用 Serilog 的静态 Log 类写日志，不需要再自己构造 LoggerConfiguration。

输出行为

SetLog 初始化后会挂载以下 sink：

注意：Information 级别不会写入文件。如果需要完整落盘，请自行追加一个不限级别的 File sink。

API

// 基础配置
InitLog.SetLog(RunModeEnum mode,
               int retainedFileCountLimit = 30,
               string path = "logs",
               long fileSize = 10485760);

// 带 Seq 的配置（自动附加 Application / MachineName 属性）
InitLog.SetLog(RunModeEnum mode,
               string applicationName,
               string machineName,
               string seqUrl,
               int retainedFileCountLimit = 30,
               string path = "logs",
               long fileSize = 10485760);

// 精简输出模板（时间只到秒）
InitLog.SetLogSimple(RunModeEnum mode, ...);

// 输出模板不含日期前缀
InitLog.SetLogWithoutDate(RunModeEnum mode, ...);

RunModeEnum.Debug 输出毫秒级时间戳并全量打印；RunModeEnum.Release 额外把 Microsoft / System 命名空间压到 Warning 级别，减少框架噪音。

此外，SetLog 会自动接管 AppDomain.UnhandledException 与 ProcessExit，未捕获异常与进程退出都会留下一条 Warning 记录。

把日志接到界面

InMemorySink.OnLogReceivedEvent += (sender, message) =>
{
    // message 已按模板格式化，可直接追加到 TextBox / ListBox
    Dispatcher.BeginInvoke(new Action(() => logBox.AppendText(message + Environment.NewLine)));
};

事件在写日志的线程上触发，UI 场景请自行切回主线程。InMemorySimpleSink 提供同样的事件，模板更短（时间只到秒）。

.NET Framework 使用说明

本包为 netstandard2.0，net48 可直接引用，但 Serilog 各组件引用的程序集版本不同，必须启用绑定重定向，否则运行时报 FileLoadException 0x80131040。

在 .NET Framework 项目的 csproj 中确认存在：

<TargetFramework>net48</TargetFramework>
<AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
<GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>

并且不要手写 App.config 里的 Serilog 重定向条目——交由 MSBuild 自动生成，随依赖版本变化而更新。

老式（非 SDK 风格 / packages.config）工程无法通过 ProjectReference 传递依赖，请改用 PackageReference 安装本包。

版本记录

1.2.9

• Serilog 升级至 4.4.0，程序集版本由 4.3.0.0 变为 4.4.0.0
• Serilog.Sinks.Seq 升级至 9.1.0
• net48 项目升级后须重新生成绑定重定向

1.2.8 及更早

• 基础日志配置能力