博客园  :: 首页  :: 新随笔  :: 联系 :: 管理

log4net的日志输出格式-log4net.Layout.PatternLayout用法

Posted on 2009-06-25 16:20  周末  阅读(8483)  评论(3编辑  收藏  举报

轉換字符

效果

a

等同於 appdomain

appdomain

Used to output the friendly name of the AppDomain where the logging event was generated.

用於輸出日誌事件發生的AppDomain的一個友好的名字

c

等同於logger

C

等同於type

class

等同於type

d

等同於date

date

用於輸出日誌事件在當前時區中的日期.若要輸出通用時間,請使用%utcdate模式.日期轉換指定符後可以跟隨一對閉合的花括號, 花括號裡面為日期格式指定符.例如: %date{HH:mm:ss,fff}%date{dd MMM yyyy HH:mm:ss,fff},若沒有指定任何格式,默認為ISO8601(Iso8601DateFormatter).

格式指定符和TOString的語法一樣.

為了達到較好的效果,建議使用log4net日期格式化器.他們可以使用以下一個字符串”ABSOLUTE”,”DATE”,”ISO8601”來分別指定AbsoluteTimeDateFormatter, DateTimeDateFormatterIso8601DateFormatter.例如: %date{ISO8601} or %date{ABSOLUTE}.

這些專用的日期格式化器效果比ToString好很多.

exception

用於輸出連同日誌信息一起傳入的異常.

如果一個異常對象被儲存在日誌記錄事件中,他將會被帶有trailing newline的模式輸出.否則,不會.

F

等同於 file

file

用於輸出引發日誌記錄請求的文件名稱.

例如: c:\inetpub\wwwroot\logtest\webform1.aspx.cs

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

identity

用於輸出當前用戶的用戶名(Principal.Identity.Name).

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

l

等同於location

L

等同於line

location

用於輸出產生日誌記錄事件的呼叫者的位置信息.

此位置信息依賴於CLI的實現,但是他通常為命名空間限制的方法且後用跟用圓括號括起來的呼叫者文件名和行號.

例如:LogTest.WebForm1.Button3_Click(c:\inetpub\wwwroot\logtest\webform1.aspx.cs:93)

位置信息非常有用.然而,他的產生相當慢. 盡量避免使用,除非執行速度不是問題.

level

用於輸入記錄事件的等級.

line

用於輸出引發日誌記錄請求的行號.

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

logger

用於輸出日誌記錄事件的日誌名字.這個日誌轉換符後面可以跟精度,精度是十進制常量,用花括號括起來.如果指定了精度符,則只會輸出從右向左的相應數目的名字,默認為輸入全部.

如下:日誌記錄器的名字為”a.b.c”, %logger{2}將會輸出”b.c”

m

等同於message

M

等同於 method

message

用於輸出應用程式提供給日誌記錄事件的信息.

mdc

MDC(舊名: ThreadContext.Properties)是聯合事件屬性的一部份.這個模式支持兼容性,但是等同於property.

method

用於輸出引發日誌記錄請求的方法的名字.

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

n

等同於 newline

newline

換行,等同於”\n””\r\n”

p

等同於 level

P

等同於 property

properties

等同於 property

property

 

用於輸出一個事件的指定的屬性.屬性名字要以花括號括起來並且直接放到property後面.例如:%property{user}.日誌中的每一個屬性指都需要單獨指定.Properties是日誌記錄器或追加器添加到事件中的.默認屬性為log4net:HostName,它是引發產生記錄事件的機器名字.

若果沒有指定關鍵字,比如: %property ,將會將鍵值以逗號分格列表

r

等同於 timestamp

t

等同於thread

timestamp

用於輸出從程式啟動到日誌記錄事件建立的時間,以毫秒記.

thread

用於輸出引發日誌記錄事件的線程的名字,若無線程名,則用線程號.

type

所用同logger

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

u

等同於 identity

username

用於輸出當前用戶的WindowsIdentity

警告:產生呼叫者的位置信息相當慢.盡量避免使用,除非執行速度不是問題.

utcdate

使用同date

w

等同於 username

x

等同於 ndc

X

等同於 mdc

%

%%輸出一個%