TraceListener.TraceData 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
寫入追蹤資料至特定接聽程式的輸出。
多載
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 物件,包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。
- source
- String
用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值,可指定引發追蹤的事件類型。
- id
- Int32
事件的數值識別項。
- data
- Object
要發出的追蹤資料。
- 屬性
備註
重要
這個方法並非由應用程式程式代碼直接呼叫, Debug而是由、 Trace和 TraceSource 類別的成員呼叫,以將追蹤數據寫入輸出。
默認實作會在eventCache
追蹤的頁首和頁尾中寫入、 source
eventType
和 id
參數。 參數 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 物件,包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。
- source
- String
用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值,可指定引發追蹤的事件類型。
- id
- Int32
事件的數值識別項。
- data
- Object[]
要發出做為資料的物件陣列。
- 屬性
備註
重要
這個方法並非由應用程式程式代碼直接呼叫, Debug而是由、 Trace和 TraceSource 類別的成員呼叫,以將追蹤數據寫入輸出。
默認實作會將、 eventType
和 id
參數的值source
寫入為標頭。 數據物件會使用 ToString
每個物件的 方法轉換成字串。 數據 eventCache
會寫入為頁尾,輸出數據的本質取決於 屬性的值 TraceOutputOptions 。
另請參閱
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- EventLogTraceListener
- TextWriterTraceListener
- Debug
- Trace