Log4net

2 AnsiColorTerminalAppender
??? 在ANSI 窗口終端寫下高亮度的日志事件。

3 AspNetTraceAppender
??? 能用asp.net中Trace的方式查看記錄的日志。

4 BufferingForwardingAppender
??? 在輸出到子Appenders之前先緩存日志事件。

5 ConsoleAppender
??? 將日志輸出到控制臺。

6 EventLogAppender
??? 將日志寫到Windows Event Log.

7 FileAppender
??? 將日志寫到文件中。

8 LocalSyslogAppender
??? 將日志寫到local syslog service (僅用于UNIX環境下).?
9 MemoryAppender
??? 將日志存到內存緩沖區。

10 NetSendAppender
??? 將日志輸出到Windows Messenger service.這些日志信息將在用戶終端的對話框中顯示。

11 RemoteSyslogAppender
??? 通過UDP網絡協議將日志寫到Remote syslog service。

12 RemotingAppender
??? 通過.NET Remoting將日志寫到遠程接收端。

13 RollingFileAppender
??? 將日志以回滾文件的形式寫到文件中。

14 SmtpAppender
??? 將日志寫到郵件中。

15 TraceAppender
??? 將日志寫到.NET trace 系統。

16 UdpAppender
??? 將日志connectionless UDP datagrams的形式送到遠程宿主或以UdpClient的形式廣播。 ?

?

三）???????? Filters

Appender 對象將日志以缺省的方式傳到輸出流，然后 Filter 可以按照不同的標準控制日志的輸出。 Filter 可以再配置文件中配置。最簡單的形式是在 appender 中寫明一個 Threshold. 這樣只有級別大于或等于此 Threshold 的日志才被記錄。

Filters 必須實現 log4net.Filters.IFilter 接口。

?

四）???????? Layouts

Layouts 控制日志顯示的格式樣式。日志的顯示格式如下：

"%timestamp [%thread] %-5level %logger - %message%newline"

Timestamp: 表示程序已經開始執行的時間。 單位 [ 毫秒 ] 。

Thread: 執行當前代碼的線程。

Level ：日志的級別。

Logger ：日志相關請求的名稱。

Message: 　日志消息。

?

Layouts 還可以控制日志的輸出樣式，比如以普通形式或以 xml 等形式輸出。

?

五）???????? Object Renderers

這是很重要的一項， log4net 將按照用戶定義的標準輸出日志消息。

Object Renders 必須實現 log4net.ObjectRenderer.IObjectRenerer 接口。

?

三 如何在項目中使用 log4net

下面有個基于控制臺的 demo ，舉例描述了 log4net 怎么用于輸出日志。
本例中，日志將會記錄到文件，控制臺，事件日至和Access數據庫中。

一）主要代碼:

1. 配置文件app.config


源代碼可以從 http://www.cnblogs.com/Files/Ring1981/Log4net%20Test.rar 下載。


四 log4net架構

???? log4net核心結構如下：

????

?1 <? xml?version="1.0"?encoding="utf-8"? ?>
?2 < configuration >
?3 ???? <!-- ?Register?a?section?handler?for?the?log4net?section? -->
?4 ???? < configSections >
?5 ???????? < section? name ="log4net" ?type ="System.Configuration.IgnoreSectionHandler" ? />
?6 ???? </ configSections >
?7 ???? < appSettings >
?8 ???????? <!-- ?To?enable?internal?log4net?logging?specify?the?following?appSettings?key? -->
?9 ???????? <!-- ?<add?key="log4net.Internal.Debug"?value="true"/>? --> </ appSettings >
10 ???? <!-- ?This?section?contains?the?log4net?configuration?settings? -->
11 ???? < log4net >
12 ???????? <!-- 定義輸出到文件中 -->
13 ???????? < appender? name ="LogFileAppender" ?type ="log4net.Appender.FileAppender" >
14 ???????????? <!-- 定義文件存放位置 -->
15 ???????????? < file? value ="D:\log-file1.txt" ? />
16 ???????????? <!-- ?Example?using?environment?variables?in?params? -->
17 ???????????? <!-- ?<file?value="${TMP}\log-file.txt"?/>? -->
18 ???????????? <!-- <sppendToFile?value="true"?/> -->
19 ???????????? <!-- ?An?alternate?output?encoding?can?be?specified? -->
20 ???????????? <!-- ?<encoding?value="unicodeFFFE"?/>? -->
21 ???????????? < layout? type ="log4net.Layout.PatternLayout" >
22 ???????????????? <!-- 每條日志末尾的文字說明 -->
23 ???????????????? < footer? value ="[Footer]--Test?By?Ring1981? " ? />
24 ???????????????? <!-- 輸出格式 -->
25 ???????????????? < conversionPattern? value ="%date?[%thread]?%-5level?%logger?[%ndc]?&lt;%property{auth}&gt;?-?%message%newline" ? />
26 ???????????? </ layout > ????????????
27 ???????? </ appender >
28 ???????? <!-- 定義輸出到控制臺命令行中 -->
29 ???????? < appender? name ="ConsoleAppender" ?type ="log4net.Appender.ConsoleAppender" > ????????????
30 ???????????? < layout? type ="log4net.Layout.PatternLayout" >
31 ???????????????? < conversionPattern? value ="%date?[%thread]?%-5level?%logger?[%property{NDC}]?-?%message%newline" ? />
32 ???????????? </ layout >
33 ???????? </ appender >
34 ???????? <!-- 定義輸出到windows事件中 -->
35 ???????? < appender? name ="EventLogAppender" ?type ="log4net.Appender.EventLogAppender" >
36 ???????????? < layout? type ="log4net.Layout.PatternLayout" >
37 ???????????????? < conversionPattern? value ="%date?[%thread]?%-5level?%logger?[%property{NDC}]?-?%message%newline" ? />
38 ???????????? </ layout >
39 ???????? </ appender >
40 ???????? <!-- 定義輸出到數據庫中，這里舉例輸出到Access數據庫中，數據庫為D盤的access.mdb -->
41 ???????? < appender? name ="AdoNetAppender_Access" ?type ="log4net.Appender.AdoNetAppender" >
42 ???????????? < connectionString? value ="Provider=Microsoft.Jet.OLEDB.4.0;Data?Source=D:\access.mdb" ? />
43 ???????????? < commandText? value ="INSERT?INTO?Log?([Date],[Thread],[Level],[Logger],[Message])?VALUES?(@log_date,?@thread,?@log_level,?@logger,?@message)" ? />
44 ???????????? <!-- 定義各個參數 -->
45 ???????????? < parameter >
46 ???????????????? < parameterName? value ="@log_date" ? />
47 ???????????????? < dbType? value ="String" ? />
48 ???????????????? < size? value ="255" ? />
49 ???????????????? < layout? type ="log4net.Layout.PatternLayout" >
50 ???????????????????? < conversionPattern? value ="%date" ? />
51 ???????????????? </ layout >
52 ???????????? </ parameter >
53 ???????????? < parameter >
54 ???????????????? < parameterName? value ="@thread" ? />
55 ???????????????? < dbType? value ="String" ? />
56 ???????????????? < size? value ="255" ? />
57 ???????????????? < layout? type ="log4net.Layout.PatternLayout" >
58 ???????????????????? < conversionPattern? value ="%thread" ? />
59 ???????????????? </ layout >
60 ???????????? </ parameter >
61 ???????????? < parameter >
62 ???????????????? < parameterName? value ="@log_level" ? />
63 ???????????????? < dbType? value ="String" ? />
64 ???????????????? < size? value ="50" ? />
65 ???????????????? < layout? type ="log4net.Layout.PatternLayout" >
66 ???????????????????? < conversionPattern? value ="%level" ? />
67 ???????????????? </ layout >
68 ???????????? </ parameter >
69 ???????????? < parameter >
70 ???????????????? < parameterName? value ="@logger" ? />
71 ???????????????? < dbType? value ="String" ? />
72 ???????????????? < size? value ="255" ? />
73 ???????????????? < layout? type ="log4net.Layout.PatternLayout" >
74 ???????????????????? < conversionPattern? value ="%logger" ? />
75 ???????????????? </ layout >
76 ???????????? </ parameter >
77 ???????????? < parameter >
78 ???????????????? < parameterName? value ="@message" ? />
79 ???????????????? < dbType? value ="String" ? />
80 ???????????????? < size? value ="1024" ? />
81 ???????????????? < layout? type ="log4net.Layout.PatternLayout" >
82 ???????????????????? < conversionPattern? value ="%message" ? />
83 ???????????????? </ layout >
84 ???????????? </ parameter >
85 ???????? </ appender >
86 ???????? <!-- 定義日志的輸出媒介，下面定義日志以四種方式輸出。也可以下面的按照一種類型或其他類型輸出。 -->
87 ???????? < root >
88 ???????????? < appender-ref? ref ="LogFileAppender" ? />
89 ???????????? < appender-ref? ref ="ConsoleAppender" ? />
90 ???????????? < appender-ref? ref ="EventLogAppender" ? />
91 ???????????? < appender-ref? ref ="AdoNetAppender_Access" ? />
92 ???????? </ root >
93 ???? </ log4net >
94 </ configuration >

?1 // ?Configure?log4net?using?the?.config?file
?2 [assembly:?log4net.Config.XmlConfigurator(Watch = true )]
?3 // ?This?will?cause?log4net?to?look?for?a?configuration?file
?4 // ?called?ConsoleApp.exe.config?in?the?application?base
?5 // ?directory?(i.e.?the?directory?containing?ConsoleApp.exe)
?6
?7 namespace ?ConsoleApp
?8 {
?9 ???? using ?System;
10
11 ???? /**/ /// ? <summary>
12 ???? /// ?Example?of?how?to?simply?configure?and?use?log4net
13 ???? /// ? </summary>
14 ???? public ? class ?LoggingExample
15 ???? {
16 ???????? private ? static ? readonly ?log4net.ILog?log? = ?log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
17 ????????
18 ???????? public ? static ? void ?Main( string []?args)
19 ???????? {
20 ????????????log.Error( " Error?Acc " );
21 ????????????log.Fatal( " Fatle?Acc " );????????????
22 ????????????System.Console.ReadLine();
23 ????????????
24 ????????}
25
26 ????}
27 }
28