C# 使用ILogger接口编写日志

最新推荐文章于 2025-11-13 11:06:19 发布

原创

最新推荐文章于 2025-11-13 11:06:19 发布 · 1.5k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#c# #java #数据库

.NET Core通过ILogger接口提供了一种灵活的日志记录机制，它使得日志记录与具体的日志技术解耦。通过依赖注入，可以在不同类中轻松使用相同的日志记录器实例。此外，ILogger接口支持多种日志级别，可通过扩展方法简化日志记录。

.NET 有几种不同的日志记录和跟踪工具，还有许多不同的第三方日志记录程序。尝试将一个应用程序从一种日志记录技术更改为另一种日志记录技术不是一件容易的事情，因为日志记录 API 的使用分布在整个源代码中。要使日志记录独立于任何日志记录技术，可以使用接口。

.NET Core 在NuGet 包 Microsoft.Extensions.Logging 中嵌入了泛型 ILogger接口。这个接口定义了 Log 方法。Log 方法定义了参数，来指定 LogLevel(枚举值)、事件ID(使用结构 EventId)、泛型状态信息、记录异常信息的 Exception类型，以及用字符串确定输出格式的格式化程序:

void Log<TState>(LogLevel logLevel, EventId eventide, TState state,   Exception exception, Func<TState, Exception, string> formatter)

除了 Log 方法之外，ILogger 接口还定义了 IsEnabled 方法，以基于 LogLevel检查日志记录是否启用，该接口也定义了方法 BeginScope，为日志记录返回可释放的作用域。ILogger 接口中的成员实际上是日志记录所需的全部。Log 方法有许多需要填充的参数。为了简化日志记录，在 LoggerExtensions 类中定义了 ILogger 接口的扩展方法。扩展方法，例如LogDebug、LogTrace、LogInformation、LogWarning、LogError、LogCritical 和 BeginScope 都有几个重载版本和易于使用的参数。

下面利用依赖注入，并使用包含的类 SampleController 作为一个泛型参数，注入ILogger 接口。泛型参数定义了日志记录器的类别。在泛型参数中，类别是由类