log4net 1.2.9使用指南

log4net是一个apache基金资助的项目log4j的.net移植版本,它是一个.net的dll,可以方便的加载到开发项目中,实现程序调试和运行的时候的日志信息输入,比.net自己提供的debug类和trace类要提供更多功能。

整个讨论分为两部分，第一部分是howto部分，告诉读者如何用最快的方式使log4net运作起来,第二步部分是inside部分，和读者一起探讨关于log4net层次架构设计以及一些思想.
HOWTO部分:
该部分给出一个范例，让你的第一个log4net范例尽快运行起来
先决条件:作者假设用户能够使用visual studio 2003的ide编写.net的winform程序,以及用户已经从网站上下载了一份最新的log4net(当前最新版本的下载地址:http://cvs.apache.org/dist/incubator/log4net/1.2.9/incubating-log4net-1.2.9-beta.zip)
第一步:新增项目，添加log4net引用.
通过vs.net 2003建立一个项目,然后将log4net添加到项目引用中来

第二步:设置配置文件:
建立对应项目的xml配置文件,log4net.config,文件内容如下:

1<?xml version="1.0" encoding="utf-8" ?>
2<configuration>
3 <configSections>
4 <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/>
5 </configSections>
6 <log4net>
7 <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender" >
8 <layout type="log4net.Layout.PatternLayout">
9 <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
10 </layout>
11 </appender>
12 <appender name="FileAppender" type="log4net.Appender.FileAppender">
13 <file value="c:/log-file.txt" />
14 <appendToFile value="true" />
15 <layout type="log4net.Layout.PatternLayout">
16 <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
17 </layout>
18 </appender>
19 <root>
20 <level value="INFO" />
21 <appender-ref ref="ConsoleAppender" />
22 </root>
23 <logger name="test.logger">
24 <level value="ALL" />
25 <appender-ref ref="FileAppender" />
26 </logger>
27 </log4net>
28</configuration> 第三步:在程序中设置自动加载以及监视配置文件
在AssemblyInfo.cs中增加如下语句:

1[assembly: log4net.Config.XmlConfigurator(Watch=true,ConfigFile="log4net.config")]
第四步:测试使用
在窗体中增加一个按钮，
并在该按钮的Click事件中增加如下代码:

private void trigLogger_Click(object sender, System.EventArgs e)
{
ILog log = LogManager.GetLogger("test.logger");
log.Info("Hello,World!");
}
然后首先将log4net.config复制到bin\Debug目录下，并运行程序,点击"Trigger Logger"按钮,可以看到结果大概 如下

2006-01-19 16:25:54,890 [3476] INFO Test.logger [(null)] - Hello World