位置：首页-资讯-后端开发

C# log4net日志库的用法小结

2024-04-02 19:55

短信预约 -IT技能 免费直播动态提醒

一、简述

记--log4net日志开源库的简单使用：控制日志文件大小，日志文件个数，滚动式覆盖，自由控制日志打印等级

例子打包：

http://xiazai.jb51.net/202110/yuanma/Log4netTest_jb51.rar

http://xiazai.jb51.net/202110/yuanma/apache-log4net-source_jb51.rar

http://xiazai.jb51.net/202110/yuanma/apache-log4net-binaries_jb51.rar

二、下载log4net

直接使用log4net源码或直接使用log4net源码编译对应的dll或直接使用log4net.dll

下载地址：http://logging.apache.org/log4net/download_log4net.html

例子直接使用其中4.5的dll。（请根据当前环境的.net framework框架版本进行选择，请看右键项目--》属性--》应用程序--》目标框架）

三、添加log4net.dll引用

四、添加日志配置log.config

编辑log.config内容如下：


<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <log4net>
    <appender name="MyAppender1" type="log4net.Appender.RollingFileAppender">
      <file value="app.log" />  <!--日志文件名-->
      <appendToFile value="true" /> <!--日志文件以追加方式进行-->
      <rollingStyle value="Size" />   <!--按文件大小进行滚动记录，也可以按日期-->
      <maxSizeRollBackups value="2" />  <!--最多两个日志备份，app.log.1 app.log.2-->
      <maximumFileSize value="8KB" /> <!--日志文件达到8KB就重新记一个文件-->
      <staticLogFileName value="true" />
      <layout type="log4net.Layout.PatternLayout">
        <!--每一行日志输出格式-->
        <conversionPattern value="%date [%thread] (%file:%line) %-5level %logger - %message%newline" />
      </layout>
    </appender>
 
    <logger name="Mylog1">  <!--代码通过Mylog1获取对应的logger句柄-->
        <level value="WARN" /> <!--比WARN等级低的不会输出 日志等级由高到低:OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL-->
        <appender-ref ref="MyAppender1" /> <!--启用MyAppender1-->
    </logger>
  </log4net>
</configuration>

将配置同步更新到exe输出路径

五、在AssemblyInfo.cs文件中添加log4net.dll相关参数

在AssemblyInfo.cs文件末尾添加一行(其中的log.config就是步骤四添加的配置文件)

[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log.config", Watch = true)]

六、测试例子

6.1 测试代码


namespace Log4netTest
{
    public partial class Form1 : Form
    {
        //Mylog1对应log.config种的一个logger名称
        public static readonly log4net.ILog mLogger = log4net.LogManager.GetLogger("Mylog1");
 
        public Form1()
        {
            InitializeComponent();
        }
 
        private void Form1_Load(object sender, EventArgs e)
        {
            mLogger.Error("APP Start");
            mLogger.Debug("logDebug");
            mLogger.Info("logInfo");
            mLogger.Warn("logWarn");
            mLogger.Error("logError");
            mLogger.Error(this);
        }
    }

注：代码种的Mylog1对应log.config中的一个logger名称

6.2 效果

控制日志文件大小，日志文件个数，滚动式覆盖，控制日志打印等级为WARN。

七、附

7.1 更多日志配置

http://logging.apache.org/log4net/release/manual/configuration.html

7.2 日志格式

%m(message):输出的日志消息，如ILog.Debug(…)输出的一条消息
%n(new line):换行
%d(datetime):输出当前语句运行的时刻
%r(run time):输出程序从运行到执行到当前语句时消耗的毫秒数
%t(thread id):当前语句所在的线程ID
%p(priority): 日志的当前优先级别，即DEBUG、INFO、WARN…等
%c(class):当前日志对象的名称，例如：
%f(file):输出语句所在的文件名。
%l(line)：输出语句所在的行号。
%数字：表示该项的最小长度，如果不够，则用空格填充，如“%-5level”表示level的最小宽度是5个字符，如果实际长度不够5个字符则以空格填充