TraceListener.TraceData 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將追蹤資料寫入監聽器特定的輸出。
多載
| 名稱 | Description |
|---|---|
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
將追蹤資訊、資料物件及事件資訊寫入監聽器專屬輸出。 |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
會將追蹤資訊、資料物件陣列及事件資訊寫入監聽器專屬輸出。 |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
將追蹤資訊、資料物件及事件資訊寫入監聽器專屬輸出。
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。
另請參閱
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace
適用於
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
會將追蹤資訊、資料物件陣列及事件資訊寫入監聽器專屬輸出。
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的值。
另請參閱
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace