ASP.NET中使用log4net详解

什么是log4net

log4net是Apache的一个开源项目，其目的是为.NET日志输出提供一个高效、灵活且可扩展的框架。log4net提供了丰富的日志记录机制，能够强化应用程序的可维护性和稳定性，将应用程序中各种事件输出到各种目标（文件、数据库、控制台等）。

如何使用log4net

步骤一：在项目中引用log4net

需要在项目中引用log4net.dll，并将文件复制到输出目录（可以直接在NuGet上安装log4net）。

步骤二：创建log4net配置文件

log4net使用XML文件存储配置信息，默认文件名为log4net.config。在配置文件中定义了不同的appender（日志目的地），以及如何格式化输出日志信息。

以下是一个基本配置文件的示例：

<?xml version="1.0" encoding="utf-8"?>
<log4net>
<appender name="console" type="log4net.Appender.ConsoleAppender">
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%-5level %logger - %message%newline" />
      </layout>
    </appender>
<appender name="rollingFile" type="log4net.Appender.RollingFileAppender">
      <file value="logs/log.txt"/>
      <appendToFile value="true"/>
      <rollingStyle value="Date"/>
      <datePattern value="yyyyMMdd_HHmm"/>
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%-5level %date %logger - %message%newline" />
      </layout>
      <staticLogFileName value="false"/>
      <preserveLogFileNameExtension value="true"/>
      <maximumFileSize value="10MB"/>
      <maxSizeRollBackups value="10"/>
    </appender>
<root>
      <level value="DEBUG"/>
      <appender-ref ref="console"/>
      <appender-ref ref="rollingFile" />
</root>
</log4net>

其中，定义了一个console appender和一个rolling file appender，用来分别输出到控制台和文件。日志级别为DEBUG，所有大于等于DEBUG级别的日志都会被记录。

步骤三：在代码中使用log4net

在代码中引用log4net并在应用程序启动时进行初始化。使用ILog接口来记录日志。

using log4net;
using log4net.Config;

public class MyApp
{
    private static readonly ILog log = LogManager.GetLogger(typeof(MyApp));

    static void Main(string[] args)
    {
        XmlConfigurator.Configure(new FileInfo("log4net.config"));

        log.Debug("debug message");
        log.Info("info message");
        log.Warn("warn message");
        log.Error("error message");
        log.Fatal("fatal message");

        Console.ReadLine();
    }
}

在代码中记录日志非常简单，使用ILog接口记录不同级别的日志即可。

示例说明

示例一：记录异常信息

有时候我们需要记录应用程序抛出的异常信息进行分析，下面是一个记录异常信息的示例：

catch(Exception ex)
{
    log.Error("Error occurred", ex);
}

在catch块中，我们可以使用一个参数的Error方法来记录异常信息。以上代码还可以简化为如下形式：

log.Error("Error occurred", ex);

示例二：动态更改日志级别

有时候我们需要在应用程序运行时动态地更改日志的级别，下面是一个动态更改日志级别的示例：

public static void SetLogLevel(string logLevel)
{
    if (!string.IsNullOrWhiteSpace(logLevel))
    {
        var hierarchy = (log4net.Repository.Hierarchy.Hierarchy)LogManager.GetRepository();
        var appender = hierarchy.Root.Appenders.OfType<log4net.Appender.RollingFileAppender>().SingleOrDefault();
        if (appender != null)
        {
            appender.LockingModel = new log4net.Appender.FileAppender.MinimalLock();
            hierarchy.Root.Level = hierarchy.LevelMap[logLevel];
            hierarchy.Configured = true;
        }
    }
}

以上代码用于动态更改日志级别，只需要传入一个字符串参数，更改后就能记录指定级别的日志信息了。

总结

log4net非常强大且易用，除了以上代码示例，log4net还提供了很多使用方法和功能。使用log4net进行日志记录可以更好地帮助我们进行问题排查，提高应用程序稳定性和维护性。