當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

非常完善的Log4net详细说明（转）

發布時間：2023/12/10 编程问答 52 豆豆

生活随笔收集整理的這篇文章主要介紹了非常完善的Log4net详细说明（转）小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

最可能來源：https://blog.csdn.net/ydm19891101/article/details/50561638

其它轉載者：http://www.cnblogs.com/zhangchenliang/p/4546352.html

1、概述

log4net是.Net下一個非常優秀的開源日志記錄組件。log4net記錄日志的功能非常強大。它可以將日志分不同的等級，以不同的格式，輸出到不同的媒介。本文主要是介紹如何在Visual Studio2008中使用log4net快速創建系統日志，如何擴展以輸出自定義字段。

2、一個簡單的使用實例

第一步：在項目中添加對log4net.dll的引用，這里引用版本是1.2.10.0。

第二步：程序啟動時讀取log4net的配置文件。

如果是CS程序，在根目錄的Program.cs中的Main方法中添加：

log4net.Config.XmlConfigurator.Configure();

如果是BS程序，在根目錄的Global.asax.cs（沒有新建一個）中的Application_Start方法中添加：

log4net.Config.XmlConfigurator.Configure();

無論BS還是CS程序都可直接在項目的AssemblyInfo.cs文件里添加以下的語句：

[assembly: log4net.Config .XmlConfigurator()]

也可以使用自定義的配置文件，具體請參見4.4?關聯配置文件。

第三步：修改配置文件。如果是CS程序，則在默認的App.config文件（沒有新建一個）中添加內容；如果是BS程序，則添加到Web.config文件中，添加內容一樣，這里不再列出。

App.config文件添加內容如下：

<?xml?version="1.0"?encoding="utf-8"??>

??<configSections>

<section?name="log4net"

type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"?/>

??</configSections>

??<log4net>

????<root>

??????<level?value="WARN"?/>

??????<appender-ref?ref="LogFileAppender"?/>

??????<appender-ref?ref="ConsoleAppender"?/>

????</root>

????<logger?name="testApp.Logging">

??????<level?value="DEBUG"/>

????</logger>

????<appender?name="LogFileAppender"?type="log4net.Appender.FileAppender"?>

??????<param?name="File"?value="log-file.txt"?/>

??????<param?name="AppendToFile"?value="true"?/>

??????<layout?type="log4net.Layout.PatternLayout">

????????<param?name="Header"?value="[Header]?"/>

????????<param?name="Footer"?value="[Footer]?"/>

????????<param?name="ConversionPattern"?value="%d [%t] %-5p %c [%x]??- %m%n"?/>

??????</layout>

??????<filter?type="log4net.Filter.LevelRangeFilter">

????????<param?name="LevelMin"?value="DEBUG"?/>

????????<param?name="LevelMax"?value="WARN"?/>

??????</filter>

????</appender>

????<appender?name="ConsoleAppender"??type="log4net.Appender.ConsoleAppender"?>

??????<layout?type="log4net.Layout.PatternLayout">

????????<param?name="ConversionPattern"??value="%d [%t] %-5p %c [%x] - %m%n"?/>

??????</layout>

????</appender>

??</log4net>

</configuration>

第四步：在程序使用。

log4net.ILog?log = log4net.LogManager.GetLogger("testApp.Logging");//獲取一個日志記錄器

log.Info(DateTime.Now.ToString() +?": login success");//寫入一條新log

這樣就將信息同時輸出到控制臺和寫入到文件名為“log-file.txt”的文件中，其中“log-file.txt”文件的路徑是當前程序運行所在目錄；也可以定義為絕對路徑，配置如：

<param?name="File"?value="C:/log-file.txt"?/>就寫入C盤根目錄下log-file.txt文件中，具體使用技巧參見4.2.1。

本例的實現請參見8.6附件。

3、Log4net的主要組成部分

3.1 Appenders

Appenders用來定義日志的輸出方式，即日志要寫到那種介質上去。較常用的Log4net已經實現好了，直接在配置文件中調用即可，可參見上面配置文件例子；當然也可以自己寫一個，需要從log4net.Appender.AppenderSkeleton類繼承。它還可以通過配置Filters和Layout來實現日志的過濾和輸出格式。

已經實現的輸出方式有：

AdoNetAppender?將日志記錄到數據庫中。可以采用SQL和存儲過程兩種方式。

AnsiColorTerminalAppender?將日志高亮輸出到ANSI終端。

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

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

ConsoleAppender?將日志輸出到應用程序控制臺。

EventLogAppender?將日志寫到Windows?Event?Log。

FileAppender?將日志輸出到文件。

ForwardingAppender?發送日志事件到子Appenders。

LocalSyslogAppender?將日志寫到local?syslog?service?(僅用于UNIX環境下)。

MemoryAppender?將日志存到內存緩沖區。

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

OutputDebugStringAppender?將日志輸出到Debuger，如果程序沒有Debuger，就輸出到系統Debuger。如果系統Debuger也不可用，將忽略消息。

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

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

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

SmtpAppender?將日志寫到郵件中。

SmtpPickupDirAppender?將消息以文件的方式放入一個目錄中，像IIS SMTP agent這樣的SMTP代理就可以閱讀或發送它們。

TelnetAppender?客戶端通過Telnet來接受日志事件。

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

UdpAppender?將日志以無連接UDP數據報的形式送到遠程宿主或用UdpClient的形式廣播。

3.2 Filters

使用過濾器可以過濾掉Appender輸出的內容。過濾器通常有以下幾種：

DenyAllFilter?阻止所有的日志事件被記錄

LevelMatchFilter?只有指定等級的日志事件才被記錄

LevelRangeFilter?日志等級在指定范圍內的事件才被記錄

LoggerMatchFilter?與Logger名稱匹配，才記錄

PropertyFilter?消息匹配指定的屬性值時才被記錄

StringMathFilter?消息匹配指定的字符串才被記錄

3.3 Layouts

Layout用于控制Appender的輸出格式，可以是線性的也可以是XML。

一個Appender只能有一個Layout。

最常用的Layout應該是經典格式的PatternLayout，其次是SimpleLayout，RawTimeStampLayout和ExceptionLayout。然后還有IRawLayout，XMLLayout等幾個，使用較少。Layout可以自己實現，需要從log4net.Layout.LayoutSkeleton類繼承，來輸出一些特殊需要的格式，在后面擴展時就重新實現了一個Layout。

SimpleLayout簡單輸出格式，只輸出日志級別與消息內容。

RawTimeStampLayout?用來格式化時間，在向數據庫輸出時會用到。

樣式如“yyyy-MM-dd HH:mm:ss“

ExceptionLayout需要給Logger的方法傳入Exception對象作為參數才起作用，否則就什么也不輸出。輸出的時候會包含Message和Trace。

PatterLayout使用最多的一個Layout，能輸出的信息很多，使用方式可參見上面例子中的配置文件。PatterLayout的格式化字符串見文后附注8.1。

3.4 Loggers

Logger是直接和應用程序交互的組件。Logger只是產生日志，然后由它引用的Appender記錄到指定的媒介，并由Layout控制輸出格式。

Logger提供了多種方式來記錄一個日志消息，也可以有多個Logger同時存在。每個實例化的Logger對象對被log4net作為命名實體（Named Entity）來維護。log4net使用繼承體系，也就是說假如存在兩個Logger，名字分別為a.b.c和a.b。那么a.b就是a.b.c的祖先。每個Logger都繼承了它祖先的屬性。所有的Logger都從Root繼承,Root本身也是一個Logger。

日志的等級，它們由高到底分別為：

OFF?>?FATAL?>?ERROR?>?WARN?>?INFO?>?DEBUG? >?ALL?

高于等級設定值方法（如何設置參見“配置文件詳解”）都能寫入日志，?Off所有的寫入方法都不寫到日志里，ALL則相反。例如當我們設成Info時，logger.Debug就會被忽略而不寫入文件，但是FATAL,ERROR,WARN,INFO會被寫入，因為他們等級高于INFO。

在具體寫日志時，一般可以這樣理解日志等級：

FATAL（致命錯誤）：記錄系統中出現的能使用系統完全失去功能，服務停止，系統崩潰等使系統無法繼續運行下去的錯誤。例如，數據庫無法連接，系統出現死循環。

ERROR（一般錯誤）：記錄系統中出現的導致系統不穩定，部分功能出現混亂或部分功能失效一類的錯誤。例如，數據字段為空，數據操作不可完成，操作出現異常等。

WARN（警告）：記錄系統中不影響系統繼續運行，但不符合系統運行正常條件，有可能引起系統錯誤的信息。例如，記錄內容為空，數據內容不正確等。

INFO（一般信息）：記錄系統運行中應該讓用戶知道的基本信息。例如，服務開始運行，功能已經開戶等。

DEBUG?（調試信息）：記錄系統用于調試的一切信息，內容或者是一些關鍵數據內容的輸出。

Logger實現的ILog接口，ILog定義了5個方法（Debug,Inof,Warn,Error,Fatal）分別對不同的日志等級記錄日志。這5個方法還有5個重載。以Debug為例說明一下，其它的和它差不多。

ILog中對Debug方法的定義如下：

void?Debug(object?message);

void?Debug(object?message,?Exception?ex);

還有一個布爾屬性：

bool?IsDebugEnabled {?get; }

如果使用Debug(object?message,?Exception?ex)，則無論Layout中是否定義了%exception，默認配置下日志都會輸出Exception。包括Exception的Message和Trace。如果使用Debug(object message)，則日志是不會輸出Exception。

最后還要說一個LogManager類，它用來管理所有的Logger。它的GetLogger靜態方法，可以獲得配置文件中相應的Logger：

log4net.ILog?log = log4net.LogManager.GetLogger("logger-name");

3.5 Object Renders

它將告訴logger如何把一個對象轉化為一個字符串記錄到日志里。（ILog中定義的接口接收的參數是Object，而不是String。）

例如你想把Orange對象記錄到日志中，但此時logger只會調用Orange默認的ToString方法而已。所以要定義一個OrangeRender類實現log4net.ObjectRender.IObjectRender接口，然后注冊它（我們在本文中的擴展不使用這種方法，而是直接實現一個自定義的Layout）。這時logger就會知道如何把Orange記錄到日志中了。

3.6 Repository

Repository主要用于日志對象組織結構的維護。

4、配置文件詳解

4.1?配置文件構成

主要有兩大部分，一是申明一個名為“log4net“的自定義配置節，如下所示：

??<configSections>

<section?name="log4net"

type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"?/>

??</configSections>

二是<log4net>節的具體配置，這是下面要重點說明的。

4.1.1<log4net>

所有的配置都要在<log4net>元素里定義。

支持的屬性：

debug	可選，取值是true或false，默認是false。設置為true，開啟log4net的內部調試。
update	可選，取值是Merge(合并)或Overwrite(覆蓋)，默認值是Merge。設置為Overwrite，在提交配置的時候會重置已經配置過的庫。
threshold	可選，取值是repository（庫）中注冊的level，默認值是ALL。

支持的子元素：

appender	0或多個
logger	0或多個
renderer	0或多個
root	最多一個
param	0或多個

4.1.2?<root>

實際上就是一個根logger，所有其它logger都默認繼承它，如果配置文件里沒有顯式定義，則框架使用根日志中定義的屬性。root元素沒有屬性。

支持的子元素：

appender-ref	0個或多個，要引用的appender的名字。
level	最多一個。?只有在這個級別或之上的事件才會被記錄。
param	0個或多個，?設置一些參數。

4.1.3?<logger>

支持的屬性：

name	必須的，logger的名稱
additivity	可選，取值是true或false，默認值是true。設置為false時將阻止父logger中的appender。

支持的子元素：

appender-ref	0個或多個，要引用的appender的名字。
level	最多一個。?只有在這個級別或之上的事件才會被記錄。
param	0個或多個，?設置一些參數。

4.1.4?<appender>

定義日志的輸出方式，只能作為?log4net?的子元素。name屬性必須唯一，type屬性必須指定。

支持的屬性：

name	必須的，Appender對象的名稱
type	必須的，Appender對象的輸出類型

支持的子元素：

appender-ref	0個或多個，允許此appender引用其他appender，并不是所以appender類型都支持。
filter	0個或多個，定義此app使用的過濾器。
layout	最多一個。定義appender使用的輸出格式。
param	0個或多個，?設置Appender類中對應的屬性的值。

實際上<appender>所能包含的子元素遠不止上面4個。

4.1.5?<layout>

布局，只能作為<appender>的子元素。

支持的屬性：

type	必須的，Layout的類型

支持的子元素：

param

0個或多個，?設置一些參數。

4.1.6?<filter>

過濾器，只能作為<appender>的子元素。

支持的屬性：

type	必須的，Filter的類型

支持的子元素：

param

0個或多個，?設置一些參數。

4.1.7?<param>

<param>元素可以是任何元素的子元素。

支持的屬性：

name	必須的，取值是父對象的參數名。
value	可選的，value和type中，必須有一個屬性被指定。value是一個能被轉化為參數值的字符串。
type	可選的，value和type中，必須有一個屬性被指定。type是一個類型名，如果type不是在log4net程序集中定義的，就需要使用全名。

支持的子元素：

param

0個或多個，?設置一些參數。

4.2 <appender>配置

???<appender>在配置文件中至少有一個，也可以有多個，有些<appender>類型還可以引用其他<appender>類型，具體參數可參見上表。

下面只對寫入回滾文件與輸出到數據庫（這里使用SQL數據庫）配置體會說一下，其他配置可參考官方網站：http://logging.apache.org/log4net/release/config-examples.html

4.2.1寫入回滾文件

????<appender?name="ReflectionLayout"?type="log4net.Appender.RollingFileAppender,log4net">

<!—按照日期形式輸出時，直接連接元素DatePattern的value形成文件路徑。此處使用這種方式?-->

??????<param?name="File"?value="D:/Log/"?/>

??????

??????<param?name="AppendToFile"?value="true"?/>

??????

??????<lockingModel?type="log4net.Appender.FileAppender+MinimalLock"?/>

??????<!—使用Unicode編碼-->

??????<Encoding?value="UTF-8"?/>

??????

??????<param?name="MaxSizeRollBackups"?value="10"?/>

??????

??????<param?name="StaticLogFileName"?value="false"?/>

??????

??????<param?name="RollingStyle"?value="Composite"?/>

??????

<!—此處按日期產生文件夾，文件名固定。注意"?的位置-->

??????<param?name="DatePattern"?value="yyyy-MM-dd/"ReflectionLayout.log""??/>

<!—這是按日期產生文件夾，并在文件名前也加上日期-->

??????<param name="DatePattern" value="yyyyMMdd/yyyyMMdd"-TimerServer.log""??/>

<!—這是先按日期產生文件夾，再形成下一級固定的文件夾—>

??????<param name="DatePattern" value="yyyyMMdd/"TimerServer/TimerServer.log""??/>

??????<!--每個文件的大小。只在混合方式與文件大小方式下使用。

超出大小后在所有文件名后自動增加正整數重新命名，數字最大的最早寫入。

可用的單位:KB|MB|GB。不要使用小數,否則會一直寫入當前日志-->

??????<param?name="maximumFileSize"?value="500KB"?/>

??????<param?name="CountDirection"?value="1"/>

<!—過濾設置，LevelRangeFilter為使用的過濾器。?-->

??????<filter?type="log4net.Filter.LevelRangeFilter">

????????<param?name="LevelMin"?value="DEBUG"?/>

????????<param?name="LevelMax"?value="WARN"?/>

??????</filter>

??????

<!—此處用繼承了log4net.Layout.PatternLayout的自定義布局，TGLog.ExpandLayout2

為命名空間。%property{Operator}、%property{Action}是自定義的輸出-－>

??????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

????????<param?name="ConversionPattern"

?value="記錄時間：%date?線程ID:[%thread]?日志級別：%-5level?記錄類：%logger?????操作者ID：%property{Operator}?操作類型：%property{Action}%n?????????????當前機器名:%property%n當前機器名及登錄用戶：%username %n???????????????記錄位置：%location%n?消息描述：%property{Message}%n????????????????????異常：%exception%n?消息：%message%newline%n%n"?/>

??????</layout>

</appender>

注意這些配置屬性有些是可選的，如果需要，一定要寫正確，否則要么輸出的不是自己想要的結果，要么干脆不輸出任何信息。

4.2.1寫入SQL數據庫

需要在相應的數據庫中準備好一張表，創建語句如下：

CREATE TABLE [Log] (

[ID] [int] IDENTITY (1, 1) NOT NULL ,

[Date] [datetime] NOT NULL ,

[Thread] [varchar] (100) COLLATE Chinese_PRC_CI_AS NULL ,

[Level] [varchar] (100) COLLATE Chinese_PRC_CI_AS NULL ,

[Logger] [varchar] (200) COLLATE Chinese_PRC_CI_AS NULL ,

[Operator] [int] NULL ,

[Message] [text] COLLATE Chinese_PRC_CI_AS NULL ,

[ActionType] [int] NULL ,

[Operand] [varchar] (300) COLLATE Chinese_PRC_CI_AS NULL ,

[IP] [varchar] (20) COLLATE Chinese_PRC_CI_AS NULL ,

[MachineName] [varchar] (100) COLLATE Chinese_PRC_CI_AS NULL ,

[Browser] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,

[Location] [text] COLLATE Chinese_PRC_CI_AS NULL ,

[Exception] [text] COLLATE Chinese_PRC_CI_AS NULL

)

<appender?name="ADONetAppender"?type="log4net.Appender.ADONetAppender,log4net">

<bufferSize?value="10"?/><!—或寫為<param name="BufferSize" value="10" />-->

<connectionType?value="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"?/>

<connectionString?value="data source=.;initial catalog=Test;integrated security=false;persist security info=True;User ID=sa;Password=;"?/>

<commandText?value="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Operator],[Message],[ActionType],[Operand],[IP],[MachineName],[Browser],[Location],[Exception]) VALUES (@log_date, @thread, @log_level, @logger,@operator, @message,@action_type,@operand,@ip,@machineName,@browser,@location,@exception)"?/>

<!—日志記錄時間，RawTimeStampLayout為默認的時間輸出格式?-->

??????<parameter>

????????<parameterName?value="@log_date"?/>

????????<dbType?value="DateTime"?/>

????????<layout?type="log4net.Layout.RawTimeStampLayout"?/>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@thread"?/>

????????<dbType?value="String"?/>

<!—長度不可以省略，否則不會輸出-->

????????<size?value="100"?/>

????????<layout?type="log4net.Layout.PatternLayout">

??????????<conversionPattern?value="%thread"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@log_level"?/>

????????<dbType?value="String"?/>

????????<size?value="100"?/>

????????<layout?type="log4net.Layout.PatternLayout">

??????????<conversionPattern?value="%level"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@logger"?/>

????????<dbType?value="String"?/>

????????<size?value="200"?/>

????????<layout?type="log4net.Layout.PatternLayout">

??????????<conversionPattern?value="%logger"?/>

????????</layout>

??????</parameter>

?????

??????

??????<parameter>

????????<parameterName?value="@operator"?/>

<!—設置為Int32時只有bufferSize的?value<="1"才正確輸出，沒有找出原因。-->

????????<dbType?value="Int16"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{Operator}"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@operand"?/>

????????<dbType?value="String"?/>

????????<size?value="300"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{Operand}"?/>

????????</layout>

??????</parameter>

??????<!—IP地址-->

??????<parameter>

????????<parameterName?value="@ip"?/>

????????<dbType?value="String"?/>

????????<size?value="20"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{IP}"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@machineName"?/>

????????<dbType?value="String"?/>

????????<size?value="100"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{MachineName}"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@browser"?/>

????????<dbType?value="String"?/>

????????<size?value="50"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{Browser}"?/>

????????</layout>

??????</parameter>

?????

??????<!—日志消息-->

??????<parameter>

????????<parameterName?value="@message"?/>

????????<dbType?value="String"?/>

????????<size?value="3000"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{Message}"?/>

????????</layout>

??????</parameter>

??????

??????<parameter>

????????<parameterName?value="@action_type"?/>

????????<dbType?value="Int16"?/>

????????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

??????????<conversionPattern?value="%property{ActionType}"?/>

????????</layout>

??????</parameter>

??????<!—記錄日志的位置-->

??????<parameter>

????????<parameterName?value="@location"?/>

????????<dbType?value="String"?/>

????????<size?value="2000"?/>

????????<layout?type="log4net.Layout.PatternLayout">

??????????<conversionPattern?value="%location"?/>

????????</layout>

??????</parameter>

?????

??????<!—異常信息。ExceptionLayout?為異常輸出的默認格式-->

??????<parameter>

????????<parameterName?value="@exception"?/>

????????<dbType?value="String"?/>

????????<size?value="4000"?/>

????????<layout?type="log4net.Layout.ExceptionLayout"?/>

??????</parameter>

</appender>

注意：

向表中輸出的字段不能多于數據表本身字段，而反之則可以，但這些多余字段一定使其可以為空，否則便寫不到數據庫；

輸出字段的類型一定是對應數據表字段數據類型可以隱式轉換的，而且長度也不能超過，否則也不能寫入；

數據表字段設置盡量可以為空，這樣可以避免一條日志記錄存在空數據導致后面的日志都記錄不了。

4.3<logger>的配置

在配置文件<appender>中的配置好了輸出的介質，格式，過濾方式，還要定義日志對象<logger>。

在框架的體系里，所有的日志對象都是根日志(root logger)的后代。?因此如果一個日志對象沒有在配置文件里顯式定義，則框架使用根日志中定義的屬性。在<root>標簽里，可以定義level級別值和Appender的列表。如果沒有定義LEVEL的值，則缺省為DEBUG。可以通過<appender-ref>標簽定義日志對象使用的Appender對象。<appender-ref>聲明了在其他地方定義的Appender對象的一個引用。在一個logger對象中的設置會覆蓋根日志的設置。而對Appender屬性來說，子日志對象則會繼承父日志對象的Appender列表。這種缺省的行為方式也可以通過顯式地設定<logger>標簽的additivity屬性為false而改變。

<root>不顯式申明時使用默認的配置。我覺得在使用時不定義<root>,自定義多個<logger>,在程序中記錄日志時直接使用<logger>的name來查找相應的<logger>，這樣更靈活一些。例如：

<logger?name="ReflectionLayout">

??????<level?value="DEBUG"/>

??????<appender-ref?ref="HashtableLayout"/>

??????<appender-ref?ref="ReflectionLayout"/>

??????<appender-ref?ref="ADONetAppender"/>

</logger>

4.4關聯配置文件

log4net默認關聯的是應用程序的配置文件App.config(BS程序是Web.config)，可以使用程序集自定義屬性來進行設置。下面來介紹一下這個自定義屬性：

log4net.Config.XmlConifguratorAttribute。

XmlConfiguratorAttribute有3個屬性：

ConfigFile：?配置文件的名字，文件路徑相對于應用程序目錄

(AppDomain.CurrentDomain.BaseDirectory)。ConfigFile屬性不能和ConfigFileExtension屬性一起使用。

ConfigFileExtension：?配置文件的擴展名，文件路徑相對于應用程序的目錄。ConfigFileExtension屬性不能和ConfigFile屬性一起使用。

Watch：?如果將Watch屬性設置為true，就會監視配置文件。當配置文件發生變化的時候，就會重新加載。

如果ConfigFile和ConfigFileExtension都沒有設置，則使用應用程序的配置文件App.config（Web.config）。

可以在項目的AssemblyInfo.cs文件里添加以下的語句：

?//監視默認的配置文件，App.exe.config???

[assembly: log4net.Config.XmlConfigurator(Watch =?true)]

//監視配置文件，App.exe.log4net。

[assembly: log4net. Config.XmlConfigurator(ConfigFileExtension =?"log4net", Watch =?true)]

//使用配置文件log4net.config，不監視改變。注意log4net.config文件的目錄，BS程序在站點目錄//下，CS則在應用程序啟動目錄下，如調試時在/bin/Debug下，一般將文件屬性的文件輸出目錄調為//始終復制即可

[assembly: log4net. Config.XmlConfigurator(ConfigFile =?"log4net.config")]

//使用配置文件log4net.config，不監視改變

[assembly: log4net. Config.XmlConfigurator()]

也可以在Global.asax的Application_Start里或者是Program.cs中的Main方法中添加，注意這里一定是絕對路徑，如下所示：

//這是在BS程序下，使用自定義的配置文件log4net.xml，使用Server.MapPath("~") + //@"/log4net.xml”來取得路徑。/log4net.xml為相對于站點的路徑

// ConfigureAndWatch()相當于Configure(Watch = true)

log4net.Config.XmlConfigurator.ConfigureAndWatch(

new?System.IO.FileInfo(Server.MapPath("~") +?@"/log4net.xml"));

//這是在CS程序下，可以用以下方法獲得：

string?assemblyFilePath =?Assembly.GetExecutingAssembly().Location;

string?assemblyDirPath =?Path.GetDirectoryName(assemblyFilePath);

string?configFilePath = assemblyDirPath +?"?//log4net.xml";

log4net.Config.XmlConfigurator.ConfigureAndWatch(

new?FileInfo(configFilePath));

或直接使用絕對路徑：

//使用自定義的配置文件，直接絕對路徑為：c:/log4net.config

log4net.Config.XmlConfigurator.Configure(new?System.IO.FileInfo(@"c:/log4net.config"));

5、如何記錄日志

Log4net使用很方便，先申明一個封裝類ILog?的對象，如下：

log4net.ILog?log = log4net.LogManager.GetLogger("ReflectionLayout");

其中"ReflectionLayout"便是我們自定義的日志對象<logger>的name的值。

對應5個日志輸出級別，log有5?個方法，每個方法都有兩個重載，使用如下：

try

????????????{

????????????????log.Debug("這是一個測試！");

????????????}

????????????catch(Exception?ec)

????????????{

????????????????log.Error("出現錯誤！", ec);

?????????}

如果我們需要輸出的消息是要區別開來，不按一個字符串全部輸出，就需要進行一些擴展了。

6、Log4net的簡單擴展

6.1通過重寫布局Layout輸出傳入的?message對象的屬性

6.1.1重寫Layout類

通過繼承log4net.Layout.PatternLayout類，使用log4net.Core.LoggingEvent類的方法得到了要輸出的message類的名稱，然后通過反射得到各個屬性的值，使用PatternLayout類AddConverter方法傳入得到的值。這里注意要引用用到的類的命名空間。

代碼見附注8.2。

6.1.2配置相應的配置文件

配置文件其他地方不用改動，只是需要改動<appender>中的<layout>。例如：

<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

????????<param?name="ConversionPattern"

?value="記錄時間：%date????操作者ID：%property{Operator}?????????????

操作類型：%property{Action}%n??消息描述：%property{Message}%n????????????????????異常：%exception%n?"?/>

??????</layout>

其中<layout>的type由原來的log4net.Layout.PatternLayout換為自定義的TGLog.ExpandLayout2.ReflectionLayout（TGLog.ExpandLayout2為命名空間）。%property{Operator}輸出的即為message類對象的屬性Operator的值。數據庫配置同樣，相應的字段如果是自定義的，則輸出選用自定義的<layout>。例：

??<parameter>

??????<parameterName?value="@action_type"?/>

??????<dbType?value="Int16"?/>

??????<layout?type="TGLog.ExpandLayout2.ReflectionLayout,TGLog">

?????????<conversionPattern?value="%property{ActionType}"?/>

??????</layout>

??</parameter>

6.1.3程序中如何使用

和一般使用方法基本相同，只是傳入的參數是一個自定義的類，類的屬性和配置文件中<layout>所有的%property{屬性}是一致的，即%property{屬性}在輸出的時候就查找傳入message類中有無對應的屬性，如果有就輸出值，沒有則輸出null。例：

log4net.ILog?log = log4net.LogManager.GetLogger("ReflectionLayout");

try

????????????{

????????????????log.Debug(new?LogMessage(

"操作對象：0",

?(int)TGLog.ActionType.Other,

?"這是四個參數測試")

);

????????????}

????????????catch(Exception?ec)

????????????{

????????????????log.Error(new?LogMessage(

????????????????????????????????????1,

????????????????????????????????????"操作對象：0",

????????????????????????????????????(int)TGLog.ActionType.Other,

????????????????????????????????????"這是全部參數測試",

????????????????????????????????????"192.168.1.1",

????????????????????????????????????"MyComputer",

????????????????????????????????????"Maxthon(MyIE2)Fans"),

?????????????????????????ec

);

??????}

LogMessage的全部屬性的構造方法如下：

public?LogMessage(

????????????int?operatorID,

????????????string?operand,

????????????int?ActionType,

????????????string?message,

????????????string?ip,

????????????string?machineName,

????????????string?browser

????????????)

?????{

????????????this.ActionType = ActionType;

????????????this.Operator = operatorID;

????????????this.Message = message;

????????????this.Operand = operand;

????????????this.IP = ip;

????????????this.Browser = browser;

????????????this.MachineName = machineName;

}

6.2通過重新實現ILog接口來增加輸入的參數

6.2.1重寫LogImpl，LogManager類及實現ILog接口

這種方式是通過構造一個名為IMyLog接口，是繼承Ilog接口而來，然后分別在MyLogImpl，MyLogManager重新實現IMyLog接口，增加了每種方法的參數。MyLogImpl，MyLogManager分別繼承LogImpl，LogManager而來。

代碼分別見8.3、8.4、8.5：

6.2.2配置相應的配置文件

配置文件其他地方不用改動，只是需要改動<appender>中的<layout>元素name為ConversionPattern的value中輸出格式。例如：

<layout?type="?log4net.Layout.PatternLayout?">

????????<param?name="ConversionPattern"

?value="記錄時間：%date????操作者ID：%property{Operator}?????????????

操作類型：%property{Action}%n??消息描述：%property{Message}%n????????????????????異常：%exception%n?"?/>

??????</layout>

%property{參數}中的參數在MyLogImpl類中定義，如語句：

loggingEvent.Properties["Operator"] = operatorID;

就定義了Operator輸出參數，即%property{Operator}輸出的即為IMyLog中的參數operatorID的值。

數據庫配置同樣。例：

??<parameter>

??????<parameterName?value="@action_type"?/>

??????<dbType?value="Int16"?/>

??????<layout?type="?log4net.Layout.PatternLayout?">

?????????<conversionPattern?value="%property{ActionType}"?/>

??????</layout>

??</parameter>

6.2.3程序中如何使用

先引用IMyLog?，MyLogManager所在的命名空間，創建一個IMyLog對象，myLog的5?個方法，每個方法都有四個重載，增加了多參數的重載。例：

IMyLog?myLog =?MyLogManager.GetLogger("ExpandILog");

try

????????????{

myLog.Debug("這是一個參數重載測試!");??????????

}

????????????catch(Exception?ec)

????????????{

????????????????log.Error(

??????????????????????????1,

??????????????????????????"操作對象：0",

??????????????????????????(int)TGLog.ActionType.Other,

??????????????????????????"這是全部參數測試",

??????????????????????????"192.168.1.1",

??????????????????????????"MyComputer",

??????????????????????????"Maxthon(MyIE2)Fans",

??????????????????????????ec

);

??????}

7、總結

Log4net?功能很多，這里只是對已經嘗試用過的功能總結一下，普通寫日志已經足夠。需要注意的是：

1.????????????Log4net本身也有一些缺陷，比如一個記錄引起了log4net本身的異常，就會使后面的日志無法記錄下來，尤其是在寫入數據庫時。例如使用6.1擴展后，int型的屬性在<appender?>的元素<bufferSize>設置不為1時，<dbType?value="Int32"?/>時，就不能輸出到數據庫，而<dbType?value="Int16"?/>則沒任何問題。

2.????????????Log4net本身出現了異常，比如配置文件出現錯誤，有些日志輸出方式會記錄下這些異常，例如應用程序控制臺；有些則不會輸出這些錯誤，如數據庫與文件。

3.????????????擴展時也會留下一些問題。例如在使用6.1擴展輸出字段時就會出現，在log.debug(object message)中，如果message是一個自定義的類，屬性與配置文件中輸出設置也一致，構造函數時也只構造一個參數的實例，寫文件與寫數據庫都成功，而將message按沒有擴展的方式直接傳入一個字符串，即log.debug(“信息內容”)使用則只能寫入文件，而數據庫則沒寫入。自定義的Layout?就是繼承默認的PatternLayout，本來不應該出錯，但出現了問題。原因分析是自定義的message類有類型為int的屬性，作為一個對象傳入時在默認值0，而直接使用字符串則int型的字段得不到默認值，引發異常。所以建議在有擴展存在時，最好多設幾個<logger>,區分清楚，按照統一的形式記錄日志，不要混合使用。

4.????????????配置文件的設置一定要準確，在一點不正確就會導致日志不能正常輸出，所以在配置時先從最簡單的開始，同時輸出方式選擇一種能輸出log4net本身異常的方式，成功后一點一點加在新配置，這樣出錯了也容易找到那個地方配置有問題。

5.????????????log4net擴展性很強，幾乎所有的組件都可以重寫，在配置文件中配置好就可以使用。

8、附注：

8.1PatterLayout格式化字符表

轉換字符	效果
a	等價于appdomain
appdomain	引發日志事件的應用程序域的友好名稱。（使用中一般是可執行文件的名字。）
c	等價于?logger
C	等價于?type
class	等價于?type
d	等價于?date
date	發生日志事件的本地時間。?使用?DE>%utcdate?輸出UTC時間。date后面還可以跟一個日期格式，用大括號括起來。DE>例如：%date{HH:mm:ss,fff}或者%date{dd MMM yyyy HH:mm:ss,fff}。如果date后面什么也不跟，將使用ISO8601?格式?。日期格式和.Net中DateTime類的ToString方法中使用的格式是一樣。另外log4net還有3個自己的格式Formatter。?它們是?"ABSOLUTE", "DATE"和"ISO8601"分別代表?AbsoluteTimeDateFormatter, DateTimeDateFormatter和Iso8601DateFormatter。例如：%date{ISO8601}或%date{ABSOLUTE}。它們的性能要好于ToString。
exception	異常信息日志事件中必須存了一個異常對象，如果日志事件不包含沒有異常對象，將什么也不輸出。異常輸出完畢后會跟一個換行。一般會在輸出異常前加一個換行，并將異常放在最后。
F	等價于?file
file	發生日志請求的源代碼文件的名字。警告：只在調試的時候有效。調用本地信息會影響性能。
identity	當前活動用戶的名字(Principal.Identity.Name). 警告：會影響性能。（我測試的時候%identity返回都是空的。）
l	等價于?location
L	等價于?line
location	引發日志事件的方法（包括命名空間和類名），以及所在的源文件和行號。警告：會影響性能。沒有pdb文件的話，只有方法名，沒有源文件名和行號。
level	日志事件等級
line	引發日志事件的行號警告：會影響性能。
logger	記錄日志事件的Logger對象的名字。可以使用精度說明符控制Logger的名字的輸出層級，默認輸出全名。注意，精度符的控制是從右開始的。例如：logger?名為?"a.b.c"，?輸出模型為%logger{2}?，將輸出"b.c"。
m	等價于?message
M	等價于?method
message	由應用程序提供給日志事件的消息。
mdc	MDC (舊為：ThreadContext.Properties)?現在是事件屬性的一部分。?保留它是為了兼容性，它等價于?property。
method	發生日志請求的方法名（只有方法名而已）。警告：會影響性能。
n	等價于?newline
newline	換行符
ndc	NDC (nested diagnostic context)
p	等價于?level
P	等價于?property
properties	等價于?property
property	輸出事件的特殊屬性。例如：?%property{user}?輸出user屬性。屬性是由loggers或appenders添加到時間中的。?有一個默認的屬性"DE>log4net:HostName"總是會有。DE> %property將輸出所有的屬性?。（擴展后可以使用） ?
r	等價于?timestamp
t	等價于?thread
timestamp	從程序啟動到事件發生所經過的毫秒數。
thread	引發日志事件的線程，如果沒有線程名就使用線程號。
type	引發日志請求的類的全名。. 可以使用精度控制符。例如：?類名是?"log4net.Layout.PatternLayout",?格式模型是%type{1}?將輸出"PatternLayout"。（也是從右開始的。）警告：會影響性能。
u	等價于?identity
username	當前用戶的WindowsIdentity。（類似：HostName/Username）警告：會影響性能。
utcdate	發生日志事件的UTC時間。DE>后面還可以跟一個日期格式，用大括號括起來。DE>例如：%utcdate{HH:mm:ss,fff}或者%utcdate{dd MMM yyyy HH:mm:ss,fff}。如果utcdate后面什么也不跟，將使用ISO8601?格式?。日期格式和.Net中DateTime類的ToString方法中使用的格式是一樣。另外log4net還有3個自己的格式Formatter。?它們是?"ABSOLUTE", "DATE"和"ISO8601"分別代表?AbsoluteTimeDateFormatter, DateTimeDateFormatter和Iso8601DateFormatter。例如：%date{ISO8601}或%date{ABSOLUTE}。它們的性能要好于ToString。
w	等價于?username
x	等價于?ndc
X	等價于?mdc
%	%%輸出一個百分號

關于調用本地信息（caller location information）的說明：

%type %file %line %method %location %class %C %F %L %l %M?都會調用本地信息。這樣做會影響性能。本地信息使用System.Diagnostics.StackTrace得到。.Net 1.0?不支持System.Diagnostics.StackTrace?類。

本地信息在調試模式下可以正常獲取，在非調試模式下可能獲取不到，或只能獲取一部分。（根據我的測試，其實是需要有一個程序數據庫（.pdb）文件。）

%property屬性要用代碼來設置才能使用（也就是擴展一下），

默認屬性log4net:HostName不用設置。

轉義字符的修飾符：

Format modifier	left justify	minimum width	maximum width	comment
%20logger	false	20	none	如果logger名不足20個字符，就在左邊補空格。
%-20logger	true	20	none	如果logger名不足20個字符，就在右邊補空格。
%.30logger	NA	none	30	超過30個字符將截斷。
%20.30logger	false	20	30	logger名要在20到30之間，少了在左邊補空格，多了截斷。
%-20.30logger	true	20	30	logger名要在20到30之間，少了在右邊補空格，多了截斷。

8.2Layout類代碼

using?System;

using?System.Collections.Generic;

using?System.Linq;

using?System.Text;

using?log4net.Layout;

using?log4net.Layout.Pattern;

using?System.Reflection;

using?System.Collections;

using?FastReflectionLib;

namespace?TGLog.ExpandLayout2

{

????public?class?ReflectionLayout?:?PatternLayout

????{

????????public?ReflectionLayout()

????????{

????????????this.AddConverter("property",?typeof(ReflectionPatternConverter));

????????}

????}

????public?class?ReflectionPatternConverter?:?PatternLayoutConverter

????{

????????protected?override?void?Convert(

System.IO.TextWriter?writer,

?log4net.Core.LoggingEvent?loggingEvent

)

????????{

????????????if?(Option !=?null)

????????????{

????????????????//?寫入指定鍵的值

????????????????WriteObject(

writer,

?loggingEvent.Repository,

?LookupProperty(Option,

?loggingEvent)

);

????????????}

????????????else

????????????{

????????????????//?寫入所有關鍵值對

????????????????WriteDictionary(

writer,

loggingEvent.Repository,

?loggingEvent.GetProperties()

);

????????????}

????????}

????????///?<summary>

????????///?通過反射獲取傳入的日志對象的某個屬性的值

????????///?</summary>

????????///?<param name="property"></param>

????????///?<returns></returns>

????????private?object?LookupProperty(

string?property,

?log4net.Core.LoggingEvent?loggingEvent)

????????{

????????????object?propertyValue =?string.Empty;

????????????PropertyInfo?propertyInfo =

loggingEvent.MessageObject.GetType().GetProperty(property);

????????????if?(propertyInfo !=?null)

????????????{

????????????????propertyValue =

propertyInfo.GetValue(loggingEvent.MessageObject,?null);

????????????}

????????????return?propertyValue;

????????}

????}

}

8.3?MyLogImpl類代碼

using?System;

using?System.Collections.Generic;

using?System.Linq;

using?System.Text;

using?log4net.Core;

namespace?TGLog.ExpandILog

{

????public?class?MyLogImpl?:?LogImpl,?IMyLog

????{

????????///?<summary>

????????///?The fully qualified name of this declaring type not the type of any subclass.

????????///?</summary>

????????private?readonly?static?Type?ThisDeclaringType =?typeof(MyLogImpl);

????????public?MyLogImpl(ILogger?logger)

????????????:?base(logger)

????????{???????

????????}

????????#region?Implementation of IMyLog

????????public?void?Debug(int?operatorID,?string?operand,?int?actionType,object?message,

?string?ip,?string?browser,?string?machineName)

????????{

????????????Debug(operatorID,??operand,??actionType, message,

??ip,??browser, machineName,?null);

????????}

????????public?void?Debug(int?operatorID,?string?operand,?int?actionType,object?message,

string?ip,?string?browser,?string?machineName, System.Exception?t)

????????{

????????????if?(this.IsDebugEnabled)

????????????{

????????????????LoggingEvent?loggingEvent =

new?LoggingEvent(ThisDeclaringType, Logger.Repository,

???????????????????????????????????????Logger.Name,?Level.Info, message, t);

????????????????loggingEvent.Properties["Operator"] = operatorID;

????????????????loggingEvent.Properties["Operand"] = operand;

????????????????loggingEvent.Properties["ActionType"] = actionType;

????????????????loggingEvent.Properties["IP"] = ip;

????????????????loggingEvent.Properties["Browser"] = browser;

????????????????loggingEvent.Properties["MachineName"] = machineName;

????????????????Logger.Log(loggingEvent);

????????????}

????????}

????????public?void?Info(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName)

????????{

????????????Info(operatorID, operand, actionType, message, ip, browser, machineName,?null);

????????}

????????public?void?Info(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName, System.Exception?t)

????????{

????????????if?(this.IsInfoEnabled)

????????????{

????????????????LoggingEvent?loggingEvent =

?new?LoggingEvent(ThisDeclaringType, Logger.Repository,

?Logger.Name,?Level.Info, message, t);

????????????????loggingEvent.Properties["Operator"] = operatorID;

????????????????loggingEvent.Properties["Operand"] = operand;

????????????????loggingEvent.Properties["ActionType"] = actionType;

????????????????loggingEvent.Properties["IP"] = ip;

????????????????loggingEvent.Properties["Browser"] = browser;

????????????????loggingEvent.Properties["MachineName"] = machineName;

????????????????Logger.Log(loggingEvent);

????????????}

????????}

????????public?void?Warn(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName)

????????{

????????????Warn(operatorID, operand, actionType, message, ip, browser, machineName,?null);

????????}

????????public?void?Warn(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName, System.Exception?t)

????????{

????????????if?(this.IsWarnEnabled)

????????????{

????????????????LoggingEvent?loggingEvent =

?new?LoggingEvent(ThisDeclaringType, Logger.Repository,

Logger.Name,?Level.Info, message, t);

????????????????loggingEvent.Properties["Operator"] = operatorID;

????????????????loggingEvent.Properties["Operand"] = operand;

????????????????loggingEvent.Properties["ActionType"] = actionType;

????????????????loggingEvent.Properties["IP"] = ip;

????????????????loggingEvent.Properties["Browser"] = browser;

????????????????loggingEvent.Properties["MachineName"] = machineName;

????????????????Logger.Log(loggingEvent);

????????????}

????????}

????????public?void?Error(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName)

????????{

????????????Error(operatorID, operand, actionType, message, ip, browser, machineName,?null);

????????}

????????public?void?Error(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName, System.Exception?t)

????????{

????????????if?(this.IsErrorEnabled)

????????????{

????????????????LoggingEvent?loggingEvent =

?new?LoggingEvent(ThisDeclaringType, Logger.Repository,

?Logger.Name,?Level.Info, message, t);

????????????????loggingEvent.Properties["Operator"] = operatorID;

????????????????loggingEvent.Properties["Operand"] = operand;

????????????????loggingEvent.Properties["ActionType"] = actionType;

????????????????loggingEvent.Properties["IP"] = ip;

????????????????loggingEvent.Properties["Browser"] = browser;

????????????????loggingEvent.Properties["MachineName"] = machineName;

????????????????Logger.Log(loggingEvent);

????????????}

????????}

????????public?void?Fatal(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName)

????????{

????????????Fatal(operatorID, operand, actionType, message, ip, browser, machineName,?null);

????????}

????????public?void?Fatal(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName, System.Exception?t)

????????{

????????????if?(this.IsFatalEnabled)

????????????{

????????????????LoggingEvent?loggingEvent =

?new?LoggingEvent(ThisDeclaringType, Logger.Repository,

???????????????????????????????????????Logger.Name,?Level.Info, message, t);

????????????????loggingEvent.Properties["Operator"] = operatorID;

????????????????loggingEvent.Properties["Operand"] = operand;

????????????????loggingEvent.Properties["ActionType"] = actionType;

????????????????loggingEvent.Properties["IP"] = ip;

????????????????loggingEvent.Properties["Browser"] = browser;

????????????????loggingEvent.Properties["MachineName"] = machineName;

????????????????Logger.Log(loggingEvent);

????????????}

????????}

????????#endregion?Implementation of IMyLog

????}

}

8.4?MyLogManager類代碼

#region?Copyright & License

// Licensed under the Apache License, Version 2.0 (the "License");

// you may not use this file except in compliance with the License.

// You may obtain a copy of the License at

// http://www.apache.org/licenses/LICENSE-2.0

// Unless required by applicable law or agreed to in writing, software

// distributed under the License is distributed on an "AS IS" BASIS,

// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

// See the License for the specific language governing permissions and

// limitations under the License.

#endregion

using?System;

using?System.Reflection;

using?System.Collections;

using?log4net;

using?log4net.Core;

using?log4net.Repository;

using?log4net.Repository.Hierarchy;

namespace?TGLog.ExpandILog

{

????public?class?MyLogManager

????{

????????#region?Static Member Variables

????????///?<summary>

????????///?The wrapper map to use to hold the?<see cref="EventIDLogImpl"/>?objects

????????///?</summary>

????????private?static?readonly?WrapperMap?s_wrapperMap =?new?WrapperMap(newWrapperCreationHandler(WrapperCreationHandler));

????????#endregion

????????#region?Constructor

????????///?<summary>

????????///?Private constructor to prevent object creation

????????///?</summary>

????????private?MyLogManager() { }

????????#endregion

????????#region?Type Specific Manager Methods

????????///?<summary>

????????///?Returns the named logger if it exists

????????///?</summary>

????????///?<remarks>

????????///?<para>If the named logger exists (in the default hierarchy) then it

????????///?returns a reference to the logger, otherwise it returns

????????///?<c>null</c>.</para>

????????///?</remarks>

????????///?<param name="name">The fully qualified logger name to look for</param>

????????///?<returns>The logger found, or null</returns>

????????public?static?IMyLog?Exists(string?name)

????????{

????????????return?Exists(Assembly.GetCallingAssembly(), name);

????????}

????????///?<summary>

????????///?Returns the named logger if it exists

????????///?</summary>

????????///?<remarks>

????????///?<para>If the named logger exists (in the specified domain) then it

????????///?returns a reference to the logger, otherwise it returns

????????///?<c>null</c>.</para>

????????///?</remarks>

????????///?<param name="domain">the domain to lookup in</param>

????????///?<param name="name">The fully qualified logger name to look for</param>

????????///?<returns>The logger found, or null</returns>

????????public?static?IMyLog?Exists(string?domain,?string?name)

????????{

????????????return?WrapLogger(LoggerManager.Exists(domain, name));

????????}

????????///?<summary>

????????///?Returns the named logger if it exists

????????///?</summary>

????????///?<remarks>

????????///?<para>If the named logger exists (in the specified assembly's domain) then it

????????///?returns a reference to the logger, otherwise it returns

????????///?<c>null</c>.</para>

????????///?</remarks>

????????///?<param name="assembly">the assembly to use to lookup the domain</param>

????????///?<param name="name">The fully qualified logger name to look for</param>

????????///?<returns>The logger found, or null</returns>

????????public?static?IMyLog?Exists(Assembly?assembly,?string?name)

????????{

????????????return?WrapLogger(LoggerManager.Exists(assembly, name));

????????}

????????///?<summary>

????????///?Returns all the currently defined loggers in the default domain.

????????///?</summary>

????????///?<remarks>

????????///?<para>The root logger is?<b>not</b>?included in the returned array.</para>

????????///?</remarks>

????????///?<returns>All the defined loggers</returns>

????????public?static?IMyLog[] GetCurrentLoggers()

????????{

????????????return?GetCurrentLoggers(Assembly.GetCallingAssembly());

????????}

????????///?<summary>

????????///?Returns all the currently defined loggers in the specified domain.

????????///?</summary>

????????///?<param name="domain">the domain to lookup in</param>

????????///?<remarks>

????????///?The root logger is?<b>not</b>?included in the returned array.

????????///?</remarks>

????????///?<returns>All the defined loggers</returns>

????????public?static?IMyLog[] GetCurrentLoggers(string?domain)

????????{

????????????return?WrapLoggers(LoggerManager.GetCurrentLoggers(domain));

????????}

????????///?<summary>

????????///?Returns all the currently defined loggers in the specified assembly's domain.

????????///?</summary>

????????///?<param name="assembly">the assembly to use to lookup the domain</param>

????????///?<remarks>

????????///?The root logger is?<b>not</b>?included in the returned array.

????????///?</remarks>

????????///?<returns>All the defined loggers</returns>

????????public?static?IMyLog[] GetCurrentLoggers(Assembly?assembly)

????????{

????????????return?WrapLoggers(LoggerManager.GetCurrentLoggers(assembly));

????????}

????????///?<summary>

????????///?Retrieve or create a named logger.

????????///?</summary>

????????///?<remarks>

????????///?<para>Retrieve a logger named as the?<paramref name="name"/>

????????///?parameter. If the named logger already exists, then the

????????///?existing instance will be returned. Otherwise, a new instance is

????????///?created.</para>

????????///

????????///?<para>By default, loggers do not have a set level but inherit

????????///?it from the hierarchy. This is one of the central features of

????????///?log4net.</para>

????????///?</remarks>

????????///?<param name="name">The name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(string?name)

????????{

????????????return?GetLogger(Assembly.GetCallingAssembly(), name);

????????}

????????///?<summary>

????????///?Retrieve or create a named logger.

????????///?</summary>

????????///?<remarks>

????????///?<para>Retrieve a logger named as the?<paramref name="name"/>

????????///?parameter. If the named logger already exists, then the

????????///?existing instance will be returned. Otherwise, a new instance is

????????///?created.</para>

????????///

????????///?<para>By default, loggers do not have a set level but inherit

????????///?it from the hierarchy. This is one of the central features of

????????///?log4net.</para>

????????///?</remarks>

????????///?<param name="domain">the domain to lookup in</param>

????????///?<param name="name">The name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(string?domain,?string?name)

????????{

????????????return?WrapLogger(LoggerManager.GetLogger(domain, name));

????????}

????????///?<summary>

????????///?Retrieve or create a named logger.

????????///?</summary>

????????///?<remarks>

????????///?<para>Retrieve a logger named as the?<paramref name="name"/>

????????///?parameter. If the named logger already exists, then the

????????///?existing instance will be returned. Otherwise, a new instance is

????????///?created.</para>

????????///

????????///?<para>By default, loggers do not have a set level but inherit

????????///?it from the hierarchy. This is one of the central features of

????????///?log4net.</para>

????????///?</remarks>

????????///?<param name="assembly">the assembly to use to lookup the domain</param>

????????///?<param name="name">The name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(Assembly?assembly,?string?name)

????????{

????????????return?WrapLogger(LoggerManager.GetLogger(assembly, name));

????????}

????????///?<summary>

????????///?Shorthand for?<see cref="LogManager.GetLogger(string)"/>.

????????///?</summary>

????????///?<remarks>

????????///?Get the logger for the fully qualified name of the type specified.

????????///?</remarks>

????????///?<param name="type">The full name of?<paramref name="type"/>?will

????????///?be used as the name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(Type?type)

????????{

????????????return?GetLogger(Assembly.GetCallingAssembly(), type.FullName);

????????}

????????///?<summary>

????????///?Shorthand for?<see cref="LogManager.GetLogger(string)"/>.

????????///?</summary>

????????///?<remarks>

????????///?Get the logger for the fully qualified name of the type specified.

????????///?</remarks>

????????///?<param name="domain">the domain to lookup in</param>

????????///?<param name="type">The full name of?<paramref name="type"/>?will

????????///?be used as the name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(string?domain,?Type?type)

????????{

????????????return?WrapLogger(LoggerManager.GetLogger(domain, type));

????????}

????????///?<summary>

????????///?Shorthand for?<see cref="LogManager.GetLogger(string)"/>.

????????///?</summary>

????????///?<remarks>

????????///?Get the logger for the fully qualified name of the type specified.

????????///?</remarks>

????????///?<param name="assembly">the assembly to use to lookup the domain</param>

????????///?<param name="type">The full name of?<paramref name="type"/>?will

????????///?be used as the name of the logger to retrieve.</param>

????????///?<returns>the logger with the name specified</returns>

????????public?static?IMyLog?GetLogger(Assembly?assembly,?Type?type)

????????{

????????????return?WrapLogger(LoggerManager.GetLogger(assembly, type));

????????}

????????#endregion

????????#region?Extension Handlers

????????///?<summary>

????????///?Lookup the wrapper object for the logger specified

????????///?</summary>

????????///?<param name="logger">the logger to get the wrapper for</param>

????????///?<returns>the wrapper for the logger specified</returns>

????????private?static?IMyLog?WrapLogger(ILogger?logger)

????????{

????????????return?(IMyLog)s_wrapperMap.GetWrapper(logger);

????????}

????????///?<summary>

????????///?Lookup the wrapper objects for the loggers specified

????????///?</summary>

????????///?<param name="loggers">the loggers to get the wrappers for</param>

????????///?<returns>Lookup the wrapper objects for the loggers specified</returns>

????????private?static?IMyLog[] WrapLoggers(ILogger[] loggers)

????????{

????????????IMyLog[] results =?new?IMyLog[loggers.Length];

????????????for?(int?i = 0; i < loggers.Length; i++)

????????????{

????????????????results[i] = WrapLogger(loggers[i]);

????????????}

????????????return?results;

????????}

????????///?<summary>

????????///?Method to create the?<see cref="ILoggerWrapper"/>?objects used by

????????///?this manager.

????????///?</summary>

????????///?<param name="logger">The logger to wrap</param>

????????///?<returns>The wrapper for the logger specified</returns>

????????private?static?ILoggerWrapper?WrapperCreationHandler(ILogger?logger)

????????{

????????????return?new?MyLogImpl(logger);

????????}

????????#endregion

????}

}

8.5?IMyLog類代碼

using?System;

using?System.Collections.Generic;

using?System.Linq;

using?System.Text;

using?log4net;

namespace?TGLog.ExpandILog

{

????public?interface?IMyLog?:?ILog

????{

????????void?Debug(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName);

????????void?Debug(int?operatorID,?string?operand,?int?actionType,object?message,

string?ip,?string?browser,?string?machineName,?Exception?t);

????????void?Info(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName);

????????void?Info(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName,?Exception?t);

????????void?Warn(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName);

????????void?Warn(int?operatorID,?string?operand,?int?actionType,?object?message,

?string?ip,?string?browser,?string?machineName,?Exception?t);

????????void?Error(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName);

????????void?Error(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName,?Exception?t);

????????void?Fatal(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName);

????????void?Fatal(int?operatorID,?string?operand,?int?actionType,?object?message,

string?ip,?string?browser,?string?machineName,?Exception?t);

????}

}

8.6附件

使用log4net記錄日志

8.7參考

1、http://peibing211.blog.163.com/blog/static/37116360200992811595469/

2、http://www.cnblogs.com/qiangzi/archive/2009/09/10/1541023.html

3、http://blog.chinaunix.net/u/23701/showart_1414206.html

4、http://itrust.cnblogs.com/archive/2005/01/25/97225.html

5、http://www.cnitblog.com/seeyeah/archive/2009/09/20/61491.aspx

6、http://www.cnblogs.com/zhmore/archive/2009/03/19/1416707.html

7、http://blog.shinylife.net/blog/article.asp?id=948

8、http://www.cnblogs.com/manhoo/archive/2009/06/25/1511066.html

轉載于:https://www.cnblogs.com/hao-1234-1234/p/9065332.html

總結

以上是生活随笔為你收集整理的非常完善的Log4net详细说明（转）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

上一篇：二次规划的对偶形式(CVX)
下一篇：教程-上传应用公钥并获取支付宝公钥