Log4Net使用详解1
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),本实例中是控制台应用程序,配置如下(附各配置的说明):
1 <?xml version="1.0" encoding="utf-8" ?> 2 <configuration> 3 <configSections> 4 <section name="log4net" type="System.Configuration.IgnoreSectionHandler"/> 5 </configSections> 6 <appSettings> 7 </appSettings> 8 <log4net> 9 <!--定义输出到文件中--> 10 <appender name="LogFileAppender" type="log4net.Appender.FileAppender"> 11 <!--定义文件存放位置--> 12 <file value="D:/log4netfile.txt" /> 13 <appendToFile value="true" /> 14 <rollingStyle value="Date" /> 15 <datePattern value="yyyyMMdd-HH:mm:ss" /> 16 <layout type="log4net.Layout.PatternLayout"> 17 <!--每条日志末尾的文字说明--> 18 <footer value="by 周公" /> 19 <!--输出格式--> 20 <!--样例:2008-03-26 13:42:32,111 [10] INFO Log4NetDemo.MainClass [(null)] - info--> 21 <conversionPattern value="记录时间:%date 线程ID:[%thread] 日志级别:%-5level 出错类:%logger property:[%property{NDC}] - 错误描述:%message%newline" /> 22 </layout> 23 </appender> 24 <!--定义输出到控制台命令行中--> 25 <appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender"> 26 <layout type="log4net.Layout.PatternLayout"> 27 <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" /> 28 </layout> 29 </appender> 30 <!--定义输出到windows事件中--> 31 <appender name="EventLogAppender" type="log4net.Appender.EventLogAppender"> 32 <layout type="log4net.Layout.PatternLayout"> 33 <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" /> 34 </layout> 35 </appender> 36 <!--定义输出到数据库中,这里举例输出到Access数据库中,数据库为C盘的log4net.mdb--> 37 <appender name="AdoNetAppender_Access" type="log4net.Appender.AdoNetAppender"> 38 <connectionString value="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:log4net.mdb" /> 39 <commandText value="INSERT INTO LogDetails ([LogDate],[Thread],[Level],[Logger],[Message]) VALUES (@logDate, @thread, @logLevel, @logger,@message)" /> 40 <!--定义各个参数--> 41 <parameter> 42 <parameterName value="@logDate" /> 43 <dbType value="String" /> 44 <size value="240" /> 45 <layout type="log4net.Layout.PatternLayout"> 46 <conversionPattern value="%date" /> 47 </layout> 48 </parameter> 49 <parameter> 50 <parameterName value="@thread" /> 51 <dbType value="String" /> 52 <size value="240" /> 53 <layout type="log4net.Layout.PatternLayout"> 54 <conversionPattern value="%thread" /> 55 </layout> 56 </parameter> 57 <parameter> 58 <parameterName value="@logLevel" /> 59 <dbType value="String" /> 60 <size value="240" /> 61 <layout type="log4net.Layout.PatternLayout"> 62 <conversionPattern value="%level" /> 63 </layout> 64 </parameter> 65 <parameter> 66 <parameterName value="@logger" /> 67 <dbType value="String" /> 68 <size value="240" /> 69 <layout type="log4net.Layout.PatternLayout"> 70 <conversionPattern value="%logger" /> 71 </layout> 72 </parameter> 73 <parameter> 74 <parameterName value="@message" /> 75 <dbType value="String" /> 76 <size value="240" /> 77 <layout type="log4net.Layout.PatternLayout"> 78 <conversionPattern value="%message" /> 79 </layout> 80 </parameter> 81 </appender> 82 <!--定义日志的输出媒介,下面定义日志以四种方式输出。也可以下面的按照一种类型或其他类型输出。--> 83 <root> 84 <!--文件形式记录日志--> 85 <appender-ref ref="LogFileAppender" /> 86 <!--控制台控制显示日志--> 87 <appender-ref ref="ConsoleAppender" /> 88 <!--Windows事件日志--> 89 <appender-ref ref="EventLogAppender" /> 90 <!-- 如果不启用相应的日志记录,可以通过这种方式注释掉 91 <appender-ref ref="AdoNetAppender_Access" /> 92 --> 93 </root> 94 95 </log4net> 96 </configuration>
1 using System; 2 using System.Collections.Generic; 3 using System.Text; 4 using System.Windows.Forms; 5 using System.Reflection; 6 using log4net; 7 8 //注意下面的语句一定要加上,指定log4net使用.config文件来读取配置信息 9 //如果是WinForm(假定程序为MyDemo.exe,则需要一个MyDemo.exe.config文件) 10 //如果是WebForm,则从web.config中读取相关信息 11 [assembly: log4net.Config.XmlConfigurator(Watch = true)] 12 namespace Log4NetDemo 13 { 14 /// <summary> 15 /// 说明:本程序演示如何利用log4net记录程序日志信息。log4net是一个功能著名的开源日志记录组件。 16 /// 利用log4net可以方便地将日志信息记录到文件、控制台、Windows事件日志和数据库中(包括MS SQL Server, Access, Oracle9i,Oracle8i,DB2,SQLite)。 17 /// 下面的例子展示了如何利用log4net记录日志 18 /// 作者:周公 19 /// 时间:2008-3-26 20 /// 首发地址:http://blog.csdn.net/zhoufoxcn/archive/2008/03/26/2220533.aspx 21 /// </summary> 22 public class MainClass 23 { 24 public static void Main(string[] args) 25 { 26 //Application.Run(new MainForm()); 27 //创建日志记录组件实例 28 ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); 29 //记录错误日志 30 log.Error("error",new Exception("发生了一个异常")); 31 //记录严重错误 32 log.Fatal("fatal",new Exception("发生了一个致命错误")); 33 //记录一般信息 34 log.Info("info"); 35 //记录调试信息 36 log.Debug("debug"); 37 //记录警告信息 38 log.Warn("warn"); 39 Console.WriteLine("日志记录完毕。"); 40 Console.Read(); 41 } 42 } 43 }