说明:本程序演示怎样利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。利用log4net能够方便地将日志信息记录到文件、控制台、Windows事件日志和数据库(包含MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)中。而且我们还能够记载控制要记载的日志级别,能够记载的日志类别包含:FATAL(致命错误)、ERROR(一般错误)、WARN(警告)、INFO(一般信息)、DEBUG(调试信息)。要想获取最新版本号的log4net组件库,能够到官方站点下载。如今的最新版本号是1.2.10。
以下的样例展示了怎样利用log4net记录日志 。
首先从官方站点下载近期版本号的log4net组件,如今的最新版本号是1.2.10。在程序中我们仅仅须要log4net.dll文件即可了,加入�对log4net.dll的引用,就能够在程序中使用了。
接着我们配置相关的配置文件(WinForm相应的是*.exe.config,WebForm相应的是*.config),本实例中是控制台应用程序,配置例如以下(附各配置的说明):
<? xml version="1.0" encoding="utf-8" ?> < configuration > < configSections > < section name ="log4net" type ="System.Configuration.IgnoreSectionHandler" /> </ configSections > < appSettings > </ appSettings > < log4net > <!-- 定义输出到文件里 --> < appender name ="LogFileAppender" type ="log4net.Appender.FileAppender" > <!-- 定义文件存放位置 --> < file value ="D:/log4netfile.txt" /> < appendToFile value ="true" /> < rollingStyle value ="Date" /> < datePattern value ="yyyyMMdd-HH:mm:ss" /> < layout type ="log4net.Layout.PatternLayout" > <!-- 每条日志末尾的文字说明 --> < footer value ="by 周公" /> <!-- 输出格式 --> <!-- 例子:2008-03-26 13:42:32,111 [10] INFO Log4NetDemo.MainClass [(null)] - info --> < conversionPattern value ="记录时间:%date 线程ID:[%thread] 日志级别:%-5level 出错类:%logger property:[%property{NDC}] - 错误描写叙述:%message%newline" /> </ layout > </ appender > <!-- 定义输出到控制台命令行中 --> < appender name ="ConsoleAppender" type ="log4net.Appender.ConsoleAppender" > < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" /> </ layout > </ appender > <!-- 定义输出到windows事件中 --> < appender name ="EventLogAppender" type ="log4net.Appender.EventLogAppender" > < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" /> </ layout > </ appender > <!-- 定义输出到数据库中,这里举例输出到Access数据库中,数据库为C盘的log4net.mdb --> < appender name ="AdoNetAppender_Access" type ="log4net.Appender.AdoNetAppender" > < connectionString value ="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:log4net.mdb" /> < commandText value ="INSERT INTO LogDetails ([LogDate],[Thread],[Level],[Logger],[Message]) VALUES (@logDate, @thread, @logLevel, @logger,@message)" /> <!-- 定义各个參数 --> < parameter > < parameterName value ="@logDate" /> < dbType value ="String" /> < size value ="240" /> < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%date" /> </ layout > </ parameter > < parameter > < parameterName value ="@thread" /> < dbType value ="String" /> < size value ="240" /> < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%thread" /> </ layout > </ parameter > < parameter > < parameterName value ="@logLevel" /> < dbType value ="String" /> < size value ="240" /> < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%level" /> </ layout > </ parameter > < parameter > < parameterName value ="@logger" /> < dbType value ="String" /> < size value ="240" /> < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%logger" /> </ layout > </ parameter > < parameter > < parameterName value ="@message" /> < dbType value ="String" /> < size value ="240" /> < layout type ="log4net.Layout.PatternLayout" > < conversionPattern value ="%message" /> </ layout > </ parameter > </ appender > <!-- 定义日志的输出媒介,以下定义日志以四种方式输出。也能够以下的依照一种类型或其它类型输出。 --> < root > <!-- 文件形式记录日志 --> < appender-ref ref ="LogFileAppender" /> <!-- 控制台控制显示日志 --> < appender-ref ref ="ConsoleAppender" /> <!-- Windows事件日志 --> < appender-ref ref ="EventLogAppender" /> <!-- 假设不启用对应的日志记录,能够通过这样的方式凝视掉 <appender-ref ref="AdoNetAppender_Access" /> --> </ root > </ log4net > </ configuration > 程序文件:
using System; using System.Collections.Generic; using System.Text; using System.Windows.Forms; using System.Reflection; using log4net; // 注意以下的语句一定要加上,指定log4net使用.config文件来读取配置信息 // 假设是WinForm(假定程序为MyDemo.exe,则须要一个MyDemo.exe.config文件) // 假设是WebForm,则从web.config中读取相关信息 [assembly: log4net.Config.XmlConfigurator(Watch = true )] namespace Log4NetDemo{ /// <summary> /// 说明:本程序演示怎样利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。 /// 利用log4net能够方便地将日志信息记录到文件、控制台、Windows事件日志和数据库中(包含MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)。 /// 以下的样例展示了怎样利用log4net记录日志 /// 作者:周公 /// 时间:2008-3-26 /// 首发地址: /// </summary> public class MainClass { public static void Main( string [] args) { // Application.Run(new MainForm()); // 创建日志记录组件实例 ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); // 记录错误日志 log.Error( " error " , new Exception( " 发生了一个异常 " )); // 记录严重错误 log.Fatal( " fatal " , new Exception( " 发生了一个致命错误 " )); // 记录一般信息 log.Info( " info " ); // 记录调试信息 log.Debug( " debug " ); // 记录警告信息 log.Warn( " warn " ); Console.WriteLine( " 日志记录完成。 " ); Console.Read(); } }} 执行结果:
控制台上的输出
日志文件内容
在这里须要特别说明一下,注意上面的代码中有这么一句:[assembly: log4net.Config.XmlConfigurator(Watch = true)](在须要使用log4net的类的namespace处),假设没有这句就会在调试时得到例如以下留言中所说的“程序调试起来时isDebugEnable"的情况,希望大家注意。
关于未尽之处,请看周公对以下读者的一些问题的答复。