語言

TraceListener.TraceData 方法

定義

將追蹤資料寫入監聽器特定的輸出。

多載

名稱 Description
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

將追蹤資訊、資料物件及事件資訊寫入監聽器專屬輸出。

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

會將追蹤資訊、資料物件陣列及事件資訊寫入監聽器專屬輸出。

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

來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs

將追蹤資訊、資料物件及事件資訊寫入監聽器專屬輸出。

public:
 virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
public virtual void TraceData(System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object? data);
public virtual void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)

參數

eventCache
TraceEventCache

一個 TraceEventCache 包含目前程序 ID、執行緒 ID 及堆疊追蹤資訊的物件。

source
String

用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。

eventType
TraceEventType

其中一個 TraceEventType 值指定了導致追蹤的事件類型。

id
Int32

事件的數字識別碼。

data
Object

要發出的追蹤資料。

屬性

備註

Important

此方法並非設計用來直接由應用程式代碼呼叫,而是由 、 Debug及Trace類別的成員TraceSource來寫入追蹤資料輸出。

預設實作會 eventCache將 、 source、 eventType 及 id 參數寫入 trace 的標頭與頁尾。 data參數寫成追蹤訊息的主體。 ToString資料物件的方法被用來將物件轉換成 String。

另請參閱

適用於

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

來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs
來源:
TraceListener.cs

會將追蹤資訊、資料物件陣列及事件資訊寫入監聽器專屬輸出。

public:
 virtual void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
public virtual void TraceData(System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);
public virtual void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overridable Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())

參數

eventCache
TraceEventCache

一個 TraceEventCache 包含目前程序 ID、執行緒 ID 及堆疊追蹤資訊的物件。

source
String

用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。

eventType
TraceEventType

其中一個 TraceEventType 值指定了導致追蹤的事件類型。

id
Int32

事件的數字識別碼。

data
Object[]

一組要以資料形式發出的物件陣列。

屬性

備註

Important

此方法並非設計用來直接由應用程式代碼呼叫,而是由 、 Debug及Trace類別的成員TraceSource來寫入追蹤資料輸出。

預設實作會將 和 sourceeventType 參數的id值寫入為標頭。 資料物件會依 ToString 照每個物件的方法轉換成字串。 eventCache資料以頁腳形式寫入,輸出資料的性質取決於屬性TraceOutputOptions的值。

另請參閱

適用於