详解log4net的使用

log4net 是一种流行的 .NET 平台的日志记录框架，它可以记录各种级别的日志消息，并支持多种输出方式。本文将为你介绍如何在你的 .NET 项目中使用 log4net，实现灵活的日志记录功能。

安装log4net

log4net 可以通过 NuGet 包管理器安装，只需要在 Visual Studio 中打开 “NuGet 包管理器控制台”，并输入以下命令：

Install-Package log4net

创建log4net配置文件

在项目根目录下创建名为 log4net.config 的文件，文件内容如下：

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
  <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
    <file value="logs\log.txt" />
    <appendToFile value="true" />
    <rollingStyle value="Size" />
    <maxSizeRollBackups value="10" />
    <maximumFileSize value="5MB" />
    <staticLogFileName value="true" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
    </layout>
  </appender>
  <root>
    <level value="DEBUG" />
    <appender-ref ref="RollingFile" />
  </root>
</log4net>

以上配置将日志记录到名为 log.txt 的文件中，文件大小不超过 5MB，同时保留最近的 10 个备份文件。在实际项目中，你应该按照实际需求来进行配置。

在程序中使用log4net

在程序中使用 log4net 非常简单，只需要在启动时加载配置文件，并在需要记录日志的地方调用 log4net 的 API 即可。例如：

using log4net;

namespace MyNamespace {
    class MyClass {
        private static readonly ILog log = LogManager.GetLogger(typeof(MyClass));

        public void DoSomething() {
            log.Debug("开始处理数据");
            // 执行数据处理操作
            log.Debug("处理数据完成");
        }
    }
}

执行上述代码后，将在 log.txt 文件中输出类似以下格式的日志信息：

2019-10-10 14:30:00.000 [1] DEBUG MyNamespace.MyClass - 开始处理数据
2019-10-10 14:30:01.000 [1] DEBUG MyNamespace.MyClass - 处理数据完成

示例一：输出不同级别的日志

log4net 支持多种日志级别，从高到低依次为 FATAL、ERROR、WARN、INFO 和 DEBUG。通过在配置文件中设置不同的级别，可以让 log4net 输出指定级别以上的日志信息。例如，以下配置将输出 INFO 级别及以上的日志：

<root>
  <level value="INFO" />
  <appender-ref ref="RollingFile" />
</root>

在代码中，可以使用不同级别的日志记录方法，如：

log.Warn("这是一个警告日志");
log.Error("这是一个错误日志");
log.Fatal("这是一个致命错误日志");

通过设置不同的日志级别，并在代码中使用不同级别的日志记录方法，可以更好地把握日志输出的精度和效率。

示例二：输出到不同的日志文件

如果你需要把日志输出到多个不同的日志文件中，可以在配置文件中增加多个 appender，并在代码中选择指定的 appender。例如，以下配置输出 INFO 级别以上的日志到 log.txt 文件中，输出 DEBUG 级别以上的日志到 debug.txt 文件中：

<appender name="RollingDebugFile" type="log4net.Appender.RollingFileAppender">
  <file value="logs\debug.txt" />
  <!-- ... 其他配置 ... -->
</appender>

<root>
  <level value="INFO" />
  <appender-ref ref="RollingFile" />
  <appender-ref ref="RollingDebugFile" />
</root>

然后在代码中使用指定的 appender 记录日志：

log.Info("这是一个常规日志");
log.Debug("这是一个调试日志，将记录到 debug.txt 文件中");

通过指定不同的 appender，可以使不同级别、不同类型的日志都有一个专属的输出文件。