＜C#＞在 C# .NET 中,使用 LoggerExtensions方法创建日志

在 C# .NET 中，LoggerExtensions 是 Microsoft.Extensions.Logging 命名空间下的一组扩展方法，它们为 ILogger 接口提供了便捷的日志记录方式。借助这些扩展方法，你能轻松记录不同级别的日志，如调试信息、信息、警告、错误等。下面为你详细介绍其用法：

1. 引入必要的命名空间

在使用 LoggerExtensions 之前，需要引入 Microsoft.Extensions.Logging 命名空间。

using Microsoft.Extensions.Logging;

2. 创建 ILogger 实例

在 .NET 应用程序里，通常通过依赖注入的方式获取 ILogger 实例。以下是一个简单的控制器示例：

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;

namespace YourNamespace.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class HomeController : ControllerBase
    {
        private readonly ILogger<HomeController> _logger;

        public HomeController(ILogger<HomeController> logger)
        {
            _logger = logger;
        }

        // 后续使用 _logger 进行日志记录
    }
}

3. 使用 LoggerExtensions 记录不同级别的日志

3.1 调试日志

LogDebug 方法用于记录调试信息，这类信息通常在开发和调试阶段使用。

[HttpGet("debug")]
public IActionResult LogDebugMessage()
{
    _logger.LogDebug("这是一条调试日志信息");
    return Ok();
}

3.2 信息日志

LogInformation 方法用于记录一般的信息，例如系统启动、用户登录等操作。

[HttpGet("info")]
public IActionResult LogInformationMessage()
{
    _logger.LogInformation("这是一条信息日志信息");
    return Ok();
}

3.3 警告日志

LogWarning 方法用于记录可能会导致问题的情况，但不会影响系统的正常运行。

[HttpGet("warning")]
public IActionResult LogWarningMessage()
{
    _logger.LogWarning("这是一条警告日志信息");
    return Ok();
}

3.4 错误日志

LogError 方法用于记录系统中出现的错误信息，如异常等。

[HttpGet("error")]
public IActionResult LogErrorMessage()
{
    try
    {
        throw new Exception("模拟一个异常");
    }
    catch (Exception ex)
    {
        _logger.LogError(ex, "这是一条错误日志信息，发生异常: {Message}", ex.Message);
        return StatusCode(500, "发生错误");
    }
}

3.5 严重错误日志

LogCritical 方法用于记录系统中发生的严重错误，可能会导致系统无法正常运行。

[HttpGet("critical")]
public IActionResult LogCriticalMessage()
{
    _logger.LogCritical("这是一条严重错误日志信息");
    return Ok();
}

4. 日志模板和参数化日志

LoggerExtensions 支持使用日志模板和参数化日志，这样能更清晰地记录日志信息。

[HttpGet("parametrized")]
public IActionResult LogParametrizedMessage()
{
    string username = "JohnDoe";
    int userId = 123;
    _logger.LogInformation("用户 {Username} (ID: {UserId}) 登录系统", username, userId);
    return Ok();
}

总结

LoggerExtensions 为 ILogger 接口提供了丰富的扩展方法，使你能够方便地记录不同级别的日志信息。通过参数化日志，还能让日志信息更加清晰和易于维护。在实际开发中，合理使用日志记录有助于调试和监控系统的运行状态。