log4net 配置与应用

log4net是apache组织开发的日志组件, 同其姐妹log4j一样, 是一个开源项目. 可以以插件的形式应用在你的系统中. 下面仅说明如何应用在web forms项目中. 做为主要的日志输出组件.

1. 首先你应该下载log4net.dll并引入到你的项目References中.
2. 需要修改你的global.asa.cs. 配置application对象启动的时候加载log4net配置. 这一步是不可以缺少的.

protected void Application_Start(Object sender, EventArgs e)
{
   log4net.Config.DOMConfigurator.Configure();
}

3. 可以看到上面的代码没有参数. 可见是载入了缺省配置. 该配置必须设置于web.config中.
在web.cofig根节点 configuration 中加入如下section:

<configSections>
  <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
</configSections>

4.该 config section 声明了名为 log4net 的另外一个config section. 后者必须位于web.config根节点 configuration 下: 以下是一个sample:

<log4net>
    <appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
      <param name="File" value="C:\Inetpub\wwwroot\Log4netDemo\log\Applog.txt" />
      <param name="DatePattern" value="MM-dd HH:mm" />
      <param name="AppendToFile" value="true" />
       <layout type="log4net.Layout.PatternLayout">
        <header value="----------------A Simple log4net test information start------------------ " />
        <footer value="----------------A Simple log4net test information end------------------ " />
        <conversionPattern value="%date [%thread] %-5level %logger [%ndc] &lt;%property{auth}&gt; - %message%newline" />
      </layout>
    </appender>
    <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">
        <file value="C:\Inetpub\wwwroot\Log4netDemo\log\" />
        <appendToFile value="true" />
        <rollingStyle value="Date" />
        <datePattern value="yyyyMMdd'.txt'" />
        <staticLogFileName value="false" />
       <layout type="log4net.Layout.PatternLayout">
        <header value="----------------A Simple log4net test information start------------------ " />
        <footer value="----------------A Simple log4net test information end------------------ " />
        <conversionPattern value="%date [%thread] %-5level %logger [%ndc] &lt;%property{auth}&gt; - %message%newline" />
      </layout>
    </appender>
     <root>
        <level value="INFO" />
        <appender-ref ref="RollingLogFileAppender" />
    </root>
  </log4net>

5. 以上定义了多个appender. 简单来说, 每一个 appender 都是一种输出介质.
6. root节点指定了选用的 appender. 本例选用了RollingLogFileAppender. 根据配置,生成日志会按照每天分类,在Appender定义中定义了输出的格式. 和目标文本文件所在位置. (起始位置是应用程序根目录. (web.config所在目录).
7. 到目前位置就配置好了log4net. 可以在我们的应用中直接使用了.
8. 以下说明应用方法:
要输出日志, 必须首先得到带有一个别名的logger.
使用以下命令
(C#):
log4net.ILog Logger logger = log4net.LogManager.GetLogger(this.GetType());
(可以直接使用GetType得到当前类名)
之后调用
logger.Info(string message);
logger.Error(string message);
logger.Debug(string message);
即可输出日志.

在创建 Logger 设置时，需要注意 "level" 参数。Log4net 允许我们通过该参数调整日志记录级别，只有高于或等于该级别的日志才会被记录下来。   
      ( Highest) OFF > FATAL > ERROR > WARN > INFO > DEBUG > ALL (Lowest)
调试后可查找应用程序根目录下是否已经自动创建类似20080813.txt文本文件.以及是否正确输出了日志.

log4net是一个非常完善的日志组件. 有着强大的可配置性. 有助于提高开发效率.