FileLogTraceListener.TraceData 方法

定義

命名空間:

Microsoft.VisualBasic.Logging

組件:

Microsoft.VisualBasic.Forms.dll

將追蹤資料寫入輸出檔。

多載

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	寫入追蹤資訊、資料物件，及事件資訊至輸出檔或資料流。
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	將追蹤資訊、資料物件的陣列及事件資訊寫入至輸出檔或資料流。

備註

TraceData 方法並非由應用程式程式代碼呼叫。 這些方法是由、 Trace和 TraceSource 類別的成員Debug呼叫，以將追蹤數據寫入輸出。

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

寫入追蹤資訊、資料物件，及事件資訊至輸出檔或資料流。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);

public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);

override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)

參數

eventCache

TraceEventCache

TraceEventCache 物件，包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。

source

String

叫用這個方法之追蹤來源的名稱。

eventType

TraceEventType

其中一個 TraceEventType 列舉值。

id

Int32

事件的數值識別項。

data

Object

要發出的追蹤資料。

備註

這個方法：

1. 格式化輸出的數據和內容資訊。

2. 視需要建立新的記錄檔。

3. 將資訊寫入記錄檔。

如需建立新記錄檔的詳細資訊，請參閱 FullLogFileName。

下表列出輸出欄位的順序。 欄位是以 屬性所指定的字串 Delimiter 分隔，後面接著行終止符。

欄位	輸出條件	說明
source	一律	name 的值。
severity	一律	的 eventType列舉值名稱。
id	一律	id 的字串表示。
message	一律	data 的字串表示。
callStack	Callstack在屬性中TraceOutputOptions設定旗標時。	Callstack的eventCache屬性。
CorrelationID	LogicalOperationStack在屬性中TraceOutputOptions設定旗標時。	ThreadId的eventCache屬性。
DateTime	DateTime在屬性中TraceOutputOptions設定旗標時。	屬性的DateTimeeventCache字串表示。 非變異文化特性用於字串轉換。
ProcessID	ProcessId在屬性中TraceOutputOptions設定旗標時。	屬性的ProcessIdeventCache字串表示。 非變異文化特性用於字串轉換。
ThreadID	ThreadId在屬性中TraceOutputOptions設定旗標時。	ThreadId的eventCache屬性。
Timestamp	Timestamp在屬性中TraceOutputOptions設定旗標時。	屬性的TimestampeventCache字串表示。 非變異文化特性用於字串轉換。
HostName	IncludeHostName當屬性為 True時。	電腦的名稱。

另請參閱

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

將追蹤資訊、資料物件的陣列及事件資訊寫入至輸出檔或資料流。

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);

public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);

override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())

參數

eventCache

TraceEventCache

TraceEventCache 物件，包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。

source

String

叫用這個方法之追蹤來源的名稱。

eventType

TraceEventType

其中一個 TraceEventType 列舉值。

id

Int32

事件的數值識別項。

data

Object[]

要發出做為資料的物件陣列。

備註

這個方法：

1. 格式化輸出的數據和內容資訊，

2. 視需要建立新的記錄檔

3. 將資訊寫入記錄檔。

如需建立新記錄檔的詳細資訊，請參閱 FullLogFileName。

下表會依其出現的順序列出輸出欄位。 欄位是以 屬性所指定的字串 Delimiter 分隔，後面接著行終止符。

欄位	輸出條件	說明
source	一律	name 的值。
severity	一律	的 eventType列舉值名稱。
id	一律	id 的字串表示。
message	一律	字串是由 中 data每個專案的字串表示所組成，每個專案都以 Delimiter分隔。
callStack	Callstack在屬性中TraceOutputOptions設定旗標時。	Callstack的eventCache屬性。
CorrelationID	LogicalOperationStack在屬性中TraceOutputOptions設定旗標時。	ThreadId的eventCache屬性。
DateTime	DateTime在屬性中TraceOutputOptions設定旗標時。	屬性的DateTimeeventCache字串表示。 非變異文化特性用於字串轉換。
ProcessID	ProcessId在屬性中TraceOutputOptions設定旗標時。	屬性的ProcessIdeventCache字串表示。 非變異文化特性用於字串轉換。
ThreadID	ThreadId在屬性中TraceOutputOptions設定旗標時。	ThreadId的eventCache屬性。
Timestamp	Timestamp在屬性中TraceOutputOptions設定旗標時。	屬性的TimestampeventCache字串表示。 非變異文化特性用於字串轉換。
HostName	IncludeHostName當屬性為 True時。	電腦的名稱。

另請參閱

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType