【转】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),本实例中是控制台应用程序,配置如下(附各配置的说明):
代码
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>
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 /// </summary>
19 public class MainClass
20 {
21 public static void Main(string[] args)
22 {
23 //Application.Run(new MainForm());
24 //创建日志记录组件实例
25 ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
26 //记录错误日志
27 log.Error("error",new Exception("发生了一个异常"));
28 //记录严重错误
29 log.Fatal("fatal",new Exception("发生了一个致命错误"));
30 //记录一般信息
31 log.Info("info");
32 //记录调试信息
33 log.Debug("debug");
34 //记录警告信息
35 log.Warn("warn");
36 Console.WriteLine("日志记录完毕。");
37 Console.Read();
38 }
39 }
40 }
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 /// </summary>
19 public class MainClass
20 {
21 public static void Main(string[] args)
22 {
23 //Application.Run(new MainForm());
24 //创建日志记录组件实例
25 ILog log = log4net.LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
26 //记录错误日志
27 log.Error("error",new Exception("发生了一个异常"));
28 //记录严重错误
29 log.Fatal("fatal",new Exception("发生了一个致命错误"));
30 //记录一般信息
31 log.Info("info");
32 //记录调试信息
33 log.Debug("debug");
34 //记录警告信息
35 log.Warn("warn");
36 Console.WriteLine("日志记录完毕。");
37 Console.Read();
38 }
39 }
40 }