C# Log4Net学习笔记:记录日志到文件

2022-10-07,,,,

    一、基础知识

   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. 

 

《C# Log4Net学习笔记:记录日志到文件.doc》

下载本文的Word格式文档,以方便收藏与打印。