摘至：
http://www.cnblogs.com/xiaolang3/archive/2006/09/25/514424.html
|
轉換字符
|
效果
|
|
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, DateTimeDateFormatter和Iso8601DateFormatter.例如: %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
|
|
%
|
%%輸出一個%
|
-左對齊,若不足指定的長度,則右側補足缺少的空格數.
沒有任何符合,右對齊, 若不足指定的長度,則左側補足缺少的空格數.
.最大長度,若超過指定的最大長度,則從右側進行截斷.
|
格式修飾符
|
左對齊
|
最小長度
|
最大長度
|
說明
|
|
%20logger
|
false
|
20
|
none
|
若長度小於20,則左側補足空格.
|
|
%-20logger
|
true
|
20
|
none
|
若長度小於20,則右側補足空格.
|
|
%.30logger
|
NA
|
none
|
30
|
若長度大於30,則從器始位置截斷.
|
|
%20.30logger
|
false
|
20
|
30
|
若長度小於20,則左側補足空格,然而若長度大於30,則從起始位置截斷.
|
|
%-20.30logger
|
true
|
20
|
30
|
若長度小於20,則右側補足空格,然而若長度大於30,則從起始位置截斷.
|