C# Log4Net學習筆記：記錄日志到文件

    一、基礎知識

   1.1、簡介

    Log4Net是一個開源日志框架，它的功能很強大，可以將日志分為不同的等級，以不同的格式輸出到不同的存儲介質中，比如：數據庫、txt文件、內存緩沖區、郵件、控制台、ANSI終端、遠程接收端等等。

    Log4Net將日志分為五個級別，從高到低分別是：FATAL（致命錯誤）、ERROR（一般錯誤）、WARN（警告）、INFO（一般信息）、DEBUG（調試信息）。

    Log4Net有4種主要的組件，分別是Logger（記錄器）、Repository（庫）、Appender（附着器）以及 Layout（布局）。

    1.2、下載

    官方地址  GitHub地址

    二、記錄日志到文件

    2.1、Log4Net安裝

    新建一個控制台應用程序，項目右鍵->管理 NuGet 程序包->log4net。

    2.2、配置文件

    添加一個ConfigFile文件夾，然后在其下面新建一個Log4NetToFile.config的配置文件，接着在其屬性的復制到輸出目錄項下選擇始終復制。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
  </configSections>
  <log4net>
    <!--type：表示用哪種類型記錄日志，log4net.Appender.RollingFileAppender表示用文本記錄日志。-->
    <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
    
      <!--日志存儲路徑-->
      <file value="Log\" />
    
      <!--是否追加日志-->
      <appendToFile value="true" />
    
      <!--防止多線程時不能寫Log，官方說線程非安全。-->
      <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
    
      <!--配置Unicode編碼-->
      <encoding value="utf-8" />
    
      <!--是否只寫到一個文件-->
      <staticLogFileName value="false" />
    
      <!--為文件名加后綴，可用作：以日期作為文件名生成log。-->
      <datePattern value="yyyyMMdd'.txt'" />
    
      <!--可以為：Once|Size|Date|Composite-->
      <!--Composite為Size和Date的組合-->
      <rollingStyle value="Composite" />
      
      <!--日志最大個數，僅保留最新的。-->
      <!--rollingStyle節點為Size時，只能有value個日志文件。-->
      <!--rollingStyle節點為Composite時，每天只能有value個日志文件。-->
      <maxSizeRollBackups value="2" />
      
      <!--可用單位：KB|MB|GB-->
      <maximumFileSize value="2MB" />
      
      <!--過濾器-->
      
      <!--拒絕所用的日志輸出(日志記錄開關)-->
      <!--<filter type="log4net.Filter.DenyAllFilter" />-->
      
      <!--只有指定等級的日志事件才被記錄-->
      <!--<filter type="log4net.Filter.LevelMatchFilter">
        <AcceptOnMatch value="true" />
        <param name="levelToMatch" value="DEBUG" />
      </filter>
      <filter type="log4net.Filter.DenyAllFilter" />-->
      
      <!--只有指定范圍等級的日志事件才被記錄-->
      <filter type="log4net.Filter.LevelRangeFilter">    
        <param name="LevelMin" value="DEBUG" />    
        <param name="LevelMax" value="FATAL" />    
      </filter>
      
      <!--日志輸出格式-->
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%時間：%date 線程ID：[%thread] 日志級別：%-5level 出錯類：%logger 錯誤描述：%message %n" />
      </layout>
    </appender>

    <!--輸出控制級別，從高到低分別是: OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL -->
    <root>
      <priority value="ALL" />
      <level value="ALL" />
      <appender-ref ref="RollingFileAppender" />
    </root>
  </log4net>
</configuration>

    2.3、測試代碼

    class Program
    {
        //1、通過NuGet安裝log4net程序包
        //2、需要引入配置文件
        //3、通過代碼讀取配置文件
        //4、通過LogManager獲取ILog接口
        //5、寫不同等級的日志
        static void Main(string[] args)
        {
            #region 記錄日志到文件
            XmlConfigurator.Configure(new FileInfo(Path.Combine(AppDomain.CurrentDomain.BaseDirectory + "ConfigFile\\Log4NetToFile.config")));
            ILog logger = LogManager.GetLogger(typeof(Program));
            logger.Fatal("This is fatal message.");
            logger.Error("This is error message.");
            logger.Warn("This is warn message.");
            logger.Info("This is info message.");
            logger.Debug("This is debug message.");

            #region 測試maxSizeRollBackups及maximumFileSize
            //for (int i = 0; i < 1000000; i++)
            //{
            //    logger.Fatal($"第{i + 1}次寫日志");
            //}
            #endregion

            Console.Read();
            #endregion
        }
    }

    2.4、運行結果

    在bin\Debug\Log文件夾下，可以看到按日期生成的txt日志文件，內容如下：

時間：2020-05-11 23:25:11,602 線程ID：[1] 日志級別：FATAL 出錯類：LinkTo.Test.ConsoleLog4Net.Program 錯誤描述：This is fatal message. 
時間：2020-05-11 23:25:11,616 線程ID：[1] 日志級別：ERROR 出錯類：LinkTo.Test.ConsoleLog4Net.Program 錯誤描述：This is error message. 
時間：2020-05-11 23:25:11,617 線程ID：[1] 日志級別：WARN  出錯類：LinkTo.Test.ConsoleLog4Net.Program 錯誤描述：This is warn message. 
時間：2020-05-11 23:25:11,618 線程ID：[1] 日志級別：INFO  出錯類：LinkTo.Test.ConsoleLog4Net.Program 錯誤描述：This is info message. 
時間：2020-05-11 23:25:11,618 線程ID：[1] 日志級別：DEBUG 出錯類：LinkTo.Test.ConsoleLog4Net.Program 錯誤描述：This is debug message.