log4net使用详解
说明:本程序演示如何利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。利用log4net可以方便地将日志信息记录到文件、控制台、Windows事件日志和数据库(包括MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)中。并且我们还可以记载控制要记载的日志级别,可以记载的日志类别包括:FATAL(致命错误)、ERROR(一般错误)、WARN(警告)、INFO(一般信息)、DEBUG(调试信息)。要想获取最新版本的log4net组件库,可以到官方网站http://logging.apache.org/log4net/下载。现在的最新版本是1.2.10。
下面的例子展示了如何利用log4net记录日志。
首先从官方网站下载最近版本的log4net组件,现在的最新版本是1.2.10。在程序中我们只需要log4net.dll文件就行了,添加对log4net.dll的引用,就可以在程序中使用了。
接着我们配置相关的配置文件(WinForm对应的是*.exe.config,WebForm对应的是*.config),本实例中是控制台应用程序,配置如下(附各配置的说明):
<configuration>
<configSections>
<sectionname="log4net"type="System.Configuration.IgnoreSectionHandler"/>
</configSections>
<appSettings>
</appSettings>
<log4net>
<!--定义输出到文件中-->
<appendername="LogFileAppender"type="log4net.Appender.FileAppender">
<!--定义文件存放位置-->
<filevalue="D:/log4netfile.txt"/>
<appendToFilevalue="true"/>
<rollingStylevalue="Date"/>
<datePatternvalue="yyyyMMdd-HH:mm:ss"/>
<layouttype="log4net.Layout.PatternLayout">
<!--每条日志末尾的文字说明-->
<footervalue="by周公"/>
<!--输出格式-->
<!--样例:2008-03-2613:42:32,111[10]INFOLog4NetDemo.MainClass[(null)]-info-->
<conversionPatternvalue="记录时间:%date线程ID:[%thread]日志级别:%-5level出错类:%loggerproperty:[%property{NDC}]-错误描述:%message%newline"/>
</layout>
</appender>
<!--定义输出到控制台命令行中-->
<appendername="ConsoleAppender"type="log4net.Appender.ConsoleAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date[%thread]%-5level%logger[%property{NDC}]-%message%newline"/>
</layout>
</appender>
<!--定义输出到windows事件中-->
<appendername="EventLogAppender"type="log4net.Appender.EventLogAppender">
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date[%thread]%-5level%logger[%property{NDC}]-%message%newline"/>
</layout>
</appender>
<!--定义输出到数据库中,这里举例输出到Access数据库中,数据库为C盘的log4net.mdb-->
<appendername="AdoNetAppender_Access"type="log4net.Appender.AdoNetAppender">
<connectionStringvalue="Provider=Microsoft.Jet.OLEDB.4.0;DataSource=C:log4net.mdb"/>
<commandTextvalue="INSERTINTOLogDetails([LogDate],[Thread],[Level],[Logger],[Message])VALUES(@logDate,@thread,@logLevel,@logger,@message)"/>
<!--定义各个参数-->
<parameter>
<parameterNamevalue="@logDate"/>
<dbTypevalue="String"/>
<sizevalue="240"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%date"/>
</layout>
</parameter>
<parameter>
<parameterNamevalue="@thread"/>
<dbTypevalue="String"/>
<sizevalue="240"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%thread"/>
</layout>
</parameter>
<parameter>
<parameterNamevalue="@logLevel"/>
<dbTypevalue="String"/>
<sizevalue="240"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%level"/>
</layout>
</parameter>
<parameter>
<parameterNamevalue="@logger"/>
<dbTypevalue="String"/>
<sizevalue="240"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%logger"/>
</layout>
</parameter>
<parameter>
<parameterNamevalue="@message"/>
<dbTypevalue="String"/>
<sizevalue="240"/>
<layouttype="log4net.Layout.PatternLayout">
<conversionPatternvalue="%message"/>
</layout>
</parameter>
</appender>
<!--定义日志的输出媒介,下面定义日志以四种方式输出。也可以下面的按照一种类型或其他类型输出。-->
<root>
<!--文件形式记录日志-->
<appender-refref="LogFileAppender"/>
<!--控制台控制显示日志-->
<appender-refref="ConsoleAppender"/>
<!--Windows事件日志-->
<appender-refref="EventLogAppender"/>
<!--如果不启用相应的日志记录,可以通过这种方式注释掉
<appender-refref="AdoNetAppender_Access"/>
-->
</root>
</log4net>
</configuration>
程序文件:
usingSystem.Collections.Generic;
usingSystem.Text;
usingSystem.Windows.Forms;
usingSystem.Reflection;
usinglog4net;
//注意下面的语句一定要加上,指定log4net使用.config文件来读取配置信息
//如果是WinForm(假定程序为MyDemo.exe,则需要一个MyDemo.exe.config文件)
//如果是WebForm,则从web.config中读取相关信息
[assembly:log4net.Config.XmlConfigurator(Watch=true)]
namespaceLog4NetDemo
{
///<summary>
///说明:本程序演示如何利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。
///利用log4net可以方便地将日志信息记录到文件、控制台、Windows事件日志和数据库中(包括MSSQLServer,Access,Oracle9i,Oracle8i,DB2,SQLite)。
///下面的例子展示了如何利用log4net记录日志
///作者:周公
///时间:2008-3-26
///首发地址:http://blog.****.net/zhoufoxcn/archive/2008/03/26/2220533.aspx
///</summary>
publicclassMainClass
{
publicstaticvoidMain(string[]args)
{
//Application.Run(newMainForm());
//创建日志记录组件实例
ILoglog=log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
//记录错误日志
log.Error("error",newException("发生了一个异常"));
//记录严重错误
log.Fatal("fatal",newException("发生了一个致命错误"));
//记录一般信息
log.Info("info");
//记录调试信息
log.Debug("debug");
//记录警告信息
log.Warn("warn");
Console.WriteLine("日志记录完毕。");
Console.Read();
}
}
}
运行结果:
控制台上的输出
日志文件内容
在这里需要特别说明一下,注意上面的代码中有这么一句:[assembly:log4net.Config.XmlConfigurator(Watch=true)](在需要使用log4net的类的namespace处),如果没有这句就会在调试时得到如下留言中所说的“程序调试起来时isDebugEnable"的情况,希望大家注意。
关于未尽之处,请看周公对下面读者的一些问题的答复《Log4Net使用详解(续)》。