C#怎么使用Microsoft.Extensions.Logging .NET通用日志框架用法

煙雲
发布: 2025-12-13 00:49:17
原创
144人浏览过
.NET中推荐使用Microsoft.Extensions.Logging实现轻量可扩展的日志功能,支持Console、Debug等提供程序,通过依赖注入ILogger并配置级别与过滤规则实现结构化日志。

c#怎么使用microsoft.extensions.logging .net通用日志框架用法

在.NET中使用 Microsoft.Extensions.Logging 是标准且推荐的日志方式,它轻量、可扩展、支持多种日志提供程序(如 Console、Debug、EventLog、第三方如 Serilog),且与 ASP.NET Core 深度集成。核心在于配置 ILogger<t></t> 实例并注入使用,不依赖具体实现。

1. 安装必要 NuGet 包

确保项目引用以下基础包(.NET 5+ 通常已内置,但显式安装更稳妥):

  • Microsoft.Extensions.Logging(核心接口和抽象)
  • Microsoft.Extensions.Logging.Console(控制台输出,开发常用)
  • Microsoft.Extensions.Logging.Debug(输出到 Visual Studio 输出窗口)

可通过包管理器命令安装:

Install-Package Microsoft.Extensions.Logging.Console

2. 创建和配置 ILogger 实例

最常见的是在 Program.cs(.NET 6+)中配置日志服务:

var builder = WebApplication.CreateBuilder(args);
<p>// 日志配置已默认添加,可进一步自定义
builder.Logging.ClearProviders(); // 可选:清空默认提供程序
builder.Logging.AddConsole();     // 添加控制台日志
builder.Logging.AddDebug();       // 添加调试日志</p><p>var app = builder.Build();
登录后复制

非 Web 场景(如控制台应用)可手动构建 IServiceCollection

var services = new ServiceCollection();
services.AddLogging(builder =>
{
    builder.AddConsole();
    builder.SetMinimumLevel(LogLevel.Information);
});
<p>var provider = services.BuildServiceProvider();
var logger = provider.GetRequiredService<ILogger<Program>>();
logger.LogInformation("Hello from console app!");
登录后复制

3. 在类中注入并使用 ILogger<t></t>

推荐按类型注入,避免静态或全局 logger:

AdMaker AI
AdMaker AI

从0到爆款高转化AI广告生成器

AdMaker AI 65
查看详情 AdMaker AI
public class UserService
{
    private readonly ILogger<UserService> _logger;
<pre class="brush:php;toolbar:false;">public UserService(ILogger<UserService> logger)
{
    _logger = logger;
}

public void AddUser(string name)
{
    _logger.LogInformation("Adding user: {Name}", name);
    _logger.LogWarning("User {Name} already exists", name);
    _logger.LogError(new Exception("DB timeout"), "Failed to save user {Name}", name);
}
登录后复制

}

注意:
- 使用占位符 {Name} 而非字符串拼接,支持结构化日志(便于后续分析)
- 日志级别有 Trace/Debug/Information/Warning/Error/Critical,按需选择
- 异常应传入 LogError(Exception, ...) 重载,确保堆被记录

4. 配置日志级别和过滤规则

可在 appsettings.json 中精细化控制:

"Logging": {
  "LogLevel": {
    "Default": "Information",
    "Microsoft.AspNetCore": "Warning",
    "MyApp.Services.UserService": "Debug"
  }
}
登录后复制

也可代码中配置:

builder.Logging.AddFilter("MyApp.Services", LogLevel.Debug);
builder.Logging.AddFilter<ConsoleLoggerProvider>(level => level >= LogLevel.Warning);
登录后复制

过滤器支持按类别名、提供程序类型或委托判断,灵活应对不同环境需求。

基本上就这些。用好 ILogger<t></t> 的关键不是功能多,而是统一入口、结构化输出、按需分级、配置驱动——不复杂但容易忽略细节。

以上就是C#怎么使用Microsoft.Extensions.Logging .NET通用日志框架用法的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号