Log4Net之记录日志到文档详解

Posted 2020-06-10

原创文章，转载必需注明出处:http://www.ncloud.hk/%E6%8A%80%E6%9C%AF%E5%88%86%E4%BA%AB/log4net-%E4%BA%8C-%E4%B9%8B%E8%AE%B0%E5%BD%95%E6%97%A5%E5%BF%97%E5%88%B0%E6%96%87%E6%A1%A3%E8%AF%A6%E8%A7%A3/

---

 

前面一章、我们简单的介绍了log4net的功能，以及一个记录日志到文档的案例。

本节、将带领大家详细了解上节案例中各行代码的意思。

 1 <configuration>
 2   <configSections>
 3     <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
 4   </configSections>
 5   <log4net>
 6     <root>
 7       <level value="ALL"/>
 8       <appender-ref ref="FileAppender"/>
 9     </root>
10 <!--存储到文件的操作-->
11     <appender name="FileAppender" type="log4net.Appender.RollingFileAppender">    
12       <param name="File" value="Log\log.txt"/>
13       <rollingStyle value="Date"/>
14       <param name="AppendToFile" value="true"/>
15       <!--<param name="DatePattern" value="yyyy-MM-dd".txt""/>-->
16 <param name="DatePattern" value="log.txt"/>
17       <layout type="log4net.Layout.PatternLayout">
18         <param name="ConversionPattern" value="%date%n--- ThreadId=[%t]   Level=%-5p   Message=%m%n"/>
19       </layout>
20     </appender>   
21   </log4net>
22 </configuration>

View Code

首先是配置log4net.config

           <Configuration></Configuration>节点。这是config文件必须切只能包含一个的,用来包含所有的配置内容。

           <configSections></configSections>节点。这是用来为配置文件添加自定义节点的。它的内容<section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>代表着想这个配置文件添加一个用户自定义节点，节点的名称为log4net类型。IgnoreSectionHandler表示创建的节点类型。这个类型的简单介绍为：创建新的配置处理程序并将指定的配置对象添加到节处理程序集合中

           <Root></Root>节点。这个节点是根日志节点，其内容为根日志的配置，有level级别值和Appender的列表。所有的子用户节点(<logger>)都是其后代，上节代码中没有使用<logger>节点。它的内容<level value="ALL"/><appender-ref ref="FileAppender"/>代表着根节点日志记录的日志等级是记录所有等级的日志，<appender-ref>标签定义日志对象使用的Appender对象。<appender-ref>声明了在其他地方定义的Appender对象的一个引用。

           日志的等级分为以下几种：ERROR、WARN、INFO、DEBUG，ALL
                      ERROR 为严重错误 主要是程序的错误
                      WARN 为一般警告，比如session丢失
                      INFO 为一般要显示的信息，比如登录登出
                      DEBUG 为程序的调试信息

            <appender name="FileAppender" type="log4net.Appender.RollingFileAppender">则声明了你的log4net日志的保存方法等其他信息。上章的代码中日志的保存方法为“写日志到文件”所有appender的type则是RollingFileAppender。

           <Param>则是设置appender的属性，如保存的文件名，记录方式等，

           <Layout>输出日志的格式化器,用于向用户显示最后经过格式化的输出信息。输出信息可以以多种格式显示

 格式名含义
%c输出日志信息所属的类的全名
%d输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy-MM-ddHH:mm:ss}，输出类似：2002-10-18-22：10：28
%f输出日志信息所属的类的类名
%l输出日志事件的发生位置，即输出日志信息的语句处于它所在的类的第几行
%m输出代码中指定的信息，如log(message)中的message
%n输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”
%p输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL。如果是调用debug()输出的，则为DEBUG，依此类推
%r输出自应用启动到输出该日志信息所耗费的毫秒数
%t输出产生该日志事件的线程名

其次是引入log4net.config文件到你的项目中去

想将你的项目引入到log4net，你的将你刚刚配置的log4net.config文件引入到你的项目中来：

1、在项目中找到AssemblyInfo.cs文件，向文件的最后一行加入代码：

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

2、在项目的Application_Start()函数中加入代码 

log4net.Config.XmlConfigurator.Configure(new System.IO.FileInfo(Server.MapPath("log4net.config")));

最后在你的代码中成功使用log4net记录错误日志

完成以上步骤之后，你就可以在你的代码中声明ILog的变量来记录错误了，

ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
log.Error("变量不存在");

记录不同的日志等级可以用不同的函数如：log.Error(“变量不存在”)，则会在你的日志文件中生成一个等级为error的错误，同样log.Info()则会生成一个info日志信息log.debug()也是如此。