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 debug="false">
     <appender name="LogFileAppender" type="log4net.Appender.FileAppender" >
         <param name="File" value="XxxxApplication.log.txt" />
         <param name="datePattern" value="MM-dd HH:mm" />
         <param name="AppendToFile" value="true" />
         <layout type="log4net.Layout.PatternLayout">
             <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
         </layout>
     </appender>
     <appender name="HttpTraceAppender" type="log4net.Appender.ASPNetTraceAppender" >
         <layout type="log4net.Layout.PatternLayout">
             <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
         </layout>
     </appender>
     <appender name="EventLogAppender" type="log4net.Appender.EventLogAppender" >
         <layout type="log4net.Layout.PatternLayout">
             <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
         </layout>
     </appender>
     <appender name="RollingLogFileAppender" type="log4net.Appender.RollingFileAppender">
         <param name="File" value="_LogData/Log.txt" />
         <param name="AppendToFile" value="true" />
         <param name="MaxSizeRollBackups" value="10" />
         <param name="MaximumFileSize" value="5MB" />
         <param name="RollingStyle" value="Size" />
         <param name="StaticLogFileName" value="true" />
         <layout type="log4net.Layout.PatternLayout">
             <param name="ConversionPattern" value="%d [%t] %-5p %c [%x] - %m%n" />
         </layout>
     </appender>
     <root>
         <level value="DEBUG" />
         <appender-ref ref="LogFileAppender" />
     </root>
</log4net>

5. 以上定义了多个appender. 简单来说, 每一个 appender 都是一种输出介质.
6. root节点指定了选用的 appender. 本例选用了LogFileAppender. (文本文件输出). 在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);
即可输出日志.

调试后可查找应用程序根目录下是否已经自动创建XxxxxApplication.log.txt文本文件.以及是否正确输出了日志.

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

关于log4net的配置. 可参考apache组织的官方文档位于
http://logging.apache.org/log4net