Log4net

時間 2019-12-14

標籤 log4net log 简体版

原文原文鏈接

日誌記錄每每是軟件開發週期中的重要組成部分。它具備如下幾個優勢：它能夠提供應用程序運行時的精確環境，可供開發人員儘快找到應用程序中的Bug；一旦在程序中加入了Log 輸出代碼，程序運行過程當中就能生成並輸出日誌信息而無需人工干預。另外，日誌信息能夠輸出到不一樣的地方（控制檯，文件等）以備之後研究之用。html

從http://logging.apache.org/log4net/下載log4net的源代碼。解壓軟件包後，在解壓的src目錄下將log4net.sln載入Visual Studio .NET，編譯後能夠獲得log4net.dll。

或直接使用NuGet數據庫

log4net 有四個主要的組件，分別是Logger（記錄器）, Repository（庫）, Appender（附着器）以及 Layout（佈局）apache

添加-新建配置文件Log4Net.config，並在文件屬性中「複製到輸出目錄」選中「始終複製」，文件內容以下：

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

<configuration>緩存

網絡

<configSections>多線程

<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>app

</configSections>框架

<log4net>asp.net

<appender-ref ref="ErrorRollingFileAppender" />

<appender-ref ref="InfoRollingFileAppender" />

<appender-ref ref="ColoredConsoleAppender"/>

</logger>

      <file value="Log\\Info\\"/>     <!--日誌路徑-->

      <rollingStyle value="Date"/>    <!--日誌根據日期滾動-->

      <datePattern value="yyyyMMdd'.txt'"/>    <!--日誌文件名格式爲:20080831.txt-->

      <staticLogFileName value="false"/>         <!--日誌文件名是不是固定不變的-->

      <param name="MaxSizeRollBackups" value="100"/>           <!--log保留天數-->

<!--樣例：

記錄時間：2016-10-11 14:03:00,540

線程ID:[1]

日誌級別： INFO 錯誤內容-->

<conversionPattern value="記錄時間：%date %n線程ID:[%thread] %n

日誌級別： %level %message %newline "/>

</layout>

</filter>

</appender>

<conversionPattern value="記錄時間：%date %n線程ID:[%thread] %n

日誌級別： %level %message%newline "/>

</layout>

</filter>

</appender>

    <!-- 控制檯前臺顯示日誌 -->

<appender name="ColoredConsoleAppender" type="log4net.Appender.ColoredConsoleAppender">

      <mapping>

        <level value="ERROR" />

        <foreColor value="Red, HighIntensity" />

      </mapping>

      <mapping>

        <level value="Info" />

        <foreColor value="Green" />

      </mapping>

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

        <conversionPattern value="%n%date{HH:mm:ss,fff} [%-5level] %m" />

      </layout>

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

        <param name="LevelMin" value="Info" />

        <param name="LevelMax" value="Fatal" />

      </filter>

    </appender>

</log4net>

</configuration>

三、在AssemblyInfo.cs中添加代碼，用於調用Log4Net.config：

[assembly: log4net.Config.XmlConfigurator(ConfigFile = "Log4Net.config", Watch = true)]

或者在程序中添加

log4net.Config.XmlConfigurator.Configure();

四、實現LogHelper，代碼以下：

public class LogHelper

{

private static ILog log = log4net.LogManager.GetLogger("LogHelper");

/// <summary>

/// 整理異常信息

/// </summary>

/// <param name="error"></param>

/// <returns></returns>

private static string Msg(Exception error)

{

string str = "";

if (error != null)

{

str = string.Format("異常類型：{0}\r\n異常消息：{1}\r\n異常信息：{2}\r\n",

error.GetType().Name, error.Message, error.StackTrace);

}

return str;

}

/// <summary>

/// 輸出異常信息

/// </summary>

/// <param name="t"></param>

/// <param name="ex"></param>

public static void LogError(Exception ex)

{

log.Error(Msg(ex));

}

/// <summary>

/// 輸出日記信息

/// </summary>

/// <param name="str"></param>

public static void LogInfo(string str)

{

log.Info(str);

}

Log4net框架定義了一個叫作LogManager的類，用來管理全部的logger對象。它有一個GetLogger()靜態方法，用咱們提供的名字參數來檢索已經存在的Logger對象。若是框架裏不存在該Logger對象，它也會爲咱們建立一個Logger對象。LogManager.Exists（」name」）只獲取而不進行建立,不存在則返回null;

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

Repository

Repository主要用於負責日誌對象組織結構的維護。在log4net的之前版本中，框架僅支持分等級的組織結構(hierarchical organization)。這種等級結構本質上是庫的一個實現，而且定義在log4net.Repository.Hierarchy 名字空間中。要實現一個Repository，須要實現log4net.Repository.ILoggerRepository 接口。可是一般並非直接實現該接口，而是以log4net.Repository.LoggerRepositorySkeleton爲基類繼承。體系庫 (hierarchical repository )則由log4net.Repository.Hierarchy.Hierarchy類實現。

若是你是個log4net框架的使用者，而非擴展者，那麼你幾乎不會在你的代碼裏用到Repository的類。相反的，你須要用到LogManager類來自動管理庫和日誌對象。

Appender

一個好的日誌框架應該可以產生多目的地的輸出。好比說輸出到控制檯或保存到一個日誌文件。log4net 可以很好的知足這些要求。它使用一個叫作Appender的組件來定義輸出介質。正如名字所示，這些組件把它們附加到Logger日誌組件上並將輸出傳遞到輸出流中。你能夠把多個Appender組件附加到一個日誌對象上。 Log4net框架提供了幾個Appender組件。關於log4net提供的Appender組件的完整列表能夠在log4net框架的幫助手冊中找到。有了這些現成的Appender組件，通常來講經過配置Filters和Layout來實現日誌的過濾和輸出格式。可是若是你願意，能夠從log4net.Appender.AppenderSkeleton類繼承。

經過設置Type來配置輸出方式：

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 系統。

UdpAppende將日誌以無鏈接UDP數據報的形式送到遠程宿主或用UdpClient的形式廣播。

Appender Filters

一個Appender 對象缺省地將全部的日誌事件傳遞到輸出流。Appender的過濾器(Appender Filters) 能夠按照不一樣的標準過濾日誌事件。在log4net.Filter的名字空間下已經有幾個預約義的過濾器。使用這些過濾器，你能夠按照日誌級別範圍過濾日誌事件，或者按照某個特殊的字符串進行過濾。你能夠在API的幫助文件中發現更多關於過濾器的信息。

過濾器一般有如下幾種：

DenyAllFilter 阻止全部的日誌事件被記錄

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

LevelRangeFilter 日誌等級在指定範圍內的事件才被記錄

LoggerMatchFilter 與Logger名稱匹配，才記錄

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

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

Layout

Layout 組件用於向用戶顯示最後通過格式化的輸出信息。輸出信息能夠以多種格式顯示，主要依賴於咱們採用的Layout組件類型。能夠是線性的或一個XML文件。Layout組件和一個Appender組件一塊兒工做。API幫助手冊中有關於不一樣Layout組件的列表。一個Appender對象，只能對應一個Layout對象。要實現你本身的Layout類，你須要從log4net.Layout.LayoutSkeleton類繼承，它實現了ILayout接口。

Layout用於控制Appender的輸出格式，能夠是線性的也能夠是XML。

最經常使用的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。

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。

日誌的等級（level），它們由高到底分別爲：

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。

Object Renders

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

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

<log4net>

全部的配置都在<log4net>元素裏定義。

支持的屬性：

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

支持的子元素節點：

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

<root>

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

支持的子元素：

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

<logger>

在框架的體系裏，全部的日誌對象<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>，這樣更靈活。例如：

<appender-ref ref="HashtableLayout"/>

<appender-ref ref="ReflectionLayout"/>

<appender-ref ref="ADONetAppender"/>

</logger>

支持的屬性：

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

支持的子元素：

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

<appender>

日誌輸出方式，只能做爲log4net的子元素。name屬性必須惟一，type屬性必須指定。

支持的屬性：

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

支持的子元素：

appender-ref	0個或多個容許此appender引用其餘appender，並非因此appender類型都支持。
filter	0個或多個定義此app使用的過濾器。
layout	最多一個定義appender使用的輸出格式。
param	0個或多個設置Appender類中對應的屬性的值。

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

配置設置參考官方網站：

http://logging.apache.org/log4net/release/config-examples.html

<layout>

佈局，只能做爲<appender>的子元素。

支持的屬性：

type	必須的，Layout的類型

支持的子元素：

conversionPattern

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

<filter>

過濾器，只能做爲<appender>的子元素。

支持的屬性：

type	必須的，Filter的類型

支持的子元素：

param

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

<param>

<param>元素能夠是任何元素的子元素。

支持的屬性：

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

支持的子元素：

param

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

示例——寫入回滾文件：

如<file value="Log\log.txt"/>

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

<!—使用Unicode編碼-->

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

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

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

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

超出大小後在全部文件名後自動增長正整數從新命名，數字最大的最先寫入。

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

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

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

</filter>

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

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

<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>

寫入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)

<!—日誌記錄時間，RawTimeStampLayout爲默認的時間輸出格式 -->

</parameter>

<!—長度不能夠省略，不然不會輸出-->

</layout>

</parameter>

</layout>

</parameter>

</layout>

</parameter>

<!—設置爲Int32時只有bufferSize的value<="1"才正確輸出-->

</layout>

</parameter>

</layout>

</parameter>

<!—IP地址-->

</layout>

</parameter>

</layout>

</parameter>

</layout>

</parameter>

<!—日誌消息-->

</layout>

</parameter>

</layout>

</parameter>

<!—記錄日誌的位置-->

</layout>

</parameter>

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

</parameter>

</appender>

注意：

向表中輸出的字段不能多於數據表自己字段，而反之則能夠，但這些多餘字段必定使其能夠爲空，不然便寫不到數據庫；

輸出字段的類型必定是對應數據表字段數據類型能夠隱式轉換的，並且長度也不能超過，不然也不能寫入；

數據表字段設置儘可能能夠爲空，這樣能夠避免一條日誌記錄存在空數據致使後面的日誌都記錄不了。

關聯配置文件

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

log4net.Config.XmlConifguratorAttribute。

XmlConfiguratorAttribute有3個屬性：

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

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

ConfigFileExtension：配置文件的擴展名，文件路徑相對於應用程序的目錄。

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));

或直接使用絕對路徑：

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

Log4net的簡單擴展

經過重寫佈局Layout輸出傳入的 message對象的屬性

1.1重寫Layout類

經過繼承log4net.Layout.PatternLayout類，使用log4net.Core.LoggingEvent類的方法獲得了要輸出的message類的名稱，而後經過反射獲得各個屬性的值，使用PatternLayout類AddConverter方法傳入獲得的值。

1.2配置相應的配置文件

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

<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>。例：

</layout>

</parameter>

1.3程序中如何使用

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

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

2經過從新實現ILog接口來增長輸入的參數

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

這種方式是經過構造一個名爲IMyLog接口，是繼承Ilog接口而來，而後分別在MyLogImpl，MyLogManager從新實現IMyLog接口，增長了每種方法的參數。MyLogImpl，MyLogManager分別繼承LogImpl，LogManager而來。

2.2配置相應的配置文件

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

<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的值。

數據庫配置一樣。例：

</layout>

</parameter>

2.3程序中如何使用

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

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

PatterLayout格式化字符表

轉換字符	效果
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之間，少了在右邊補空格，多了截斷。