目录

使用内置的日志组件

简单过渡到第三方组件 - NLog 

使用内置的日志

下面使用控制器 HomeController.cs 进行演示。

需要 using Microsoft.Extensions.Logging;

方案一：

public class HomeController : Controller
 {
  private readonly ILogger _logger ;

  public HomeController(ILoggerFactory loggerFactory)
  {
   _logger = loggerFactory.CreateLogger(typeof(HomeController));
  }
 }

方案二：

public class HomeController : Controller
 {
  private readonly ILogger _logger ;

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

方案三：

public class HomeController : Controller
 {
  private readonly ILogger _logger ;

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

三种都是通过注入的方式获取日志记录器对象，在过去，我们会自己独立封装类似这些 Debug、Info 和 Error 等不同日志等级的方法，现在我们看看内置的方法是如何使用的？ 

在 HomeController 内添加 Index() 方法进行测试。

public IActionResult Index()
  {
   _logger.LogDebug($"测试：{DateTime.Now.ToString(CultureInfo.InvariantCulture)}");
   _logger.LogError($"测试：{DateTime.Now.ToString(CultureInfo.InvariantCulture)}");
   _logger.LogInformation($"测试：{DateTime.Now.ToString(CultureInfo.InvariantCulture)}");

   return Json(Guid.NewGuid());
  }

在输出结果中我们可以看到，不同日志的等级在控制台中会以不同的颜色进行标注。

每种级别的 Log 都有多个方法重载，如 LogInformation() ，示例演示的代码中使用的是比较简单一种，也就是最后一种。

//
    // 摘要:
    //   Formats and writes an informational log message.
    //
    // 参数:
    //  logger:
    //   The Microsoft.Extensions.Logging.ILogger to write to.
    //
    //  eventId:
    //   The event id associated with the log.
    //
    //  message:
    //   Format string of the log message.
    //
    //  args:
    //   An object array that contains zero or more objects to format.
    public static void LogInformation(this ILogger logger, EventId eventId, string message, params object[] args);
    //
    // 摘要:
    //   Formats and writes an informational log message.
    //
    // 参数:
    //  logger:
    //   The Microsoft.Extensions.Logging.ILogger to write to.
    //
    //  exception:
    //   The exception to log.
    //
    //  message:
    //   Format string of the log message.
    //
    //  args:
    //   An object array that contains zero or more objects to format.
    public static void LogInformation(this ILogger logger, Exception exception, string message, params object[] args);
    //
    // 摘要:
    //   Formats and writes an informational log message.
    //
    // 参数:
    //  logger:
    //   The Microsoft.Extensions.Logging.ILogger to write to.
    //
    //  message:
    //   Format string of the log message.
    //
    //  args:
    //   An object array that contains zero or more objects to format.
    public static void LogInformation(this ILogger logger, string message, params object[] args);

其它细节以及详情，或者希望使用其它日志组件可参考官方文档：https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging/?tabs=aspnetcore2x

简单过渡到第三方组件 - NLog

Nuget 安装 NLog.Web.AspNetCore（目前 Nuget 最新为 4.4.1，但是官方的教程却是 4.5 的，小编使用 4.4.1 进行演示）。如需 4.5+ 可参考官方：https://github.com/NLog/NLog.Web/wiki/Getting-started-with-ASP.NET-Core-2

下面演示如何将内置的组件简单的移植到 NLog 中。

先在根目录创建配置文件 nlog.config，记得将属性修改成始终复制到目录：

修改 Startup.cs 类中的 Configure() 方法，其它地方都不需要做出任何修改。

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
      loggerFactory.AddNLog();  //添加NLog 
      env.ConfigureNLog("nlog.config");  //读取Nlog配置文件 

      //...    
    }

启动程序，你会发现：