DelimitedListTraceListener.TraceEvent 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將事件追蹤資訊寫入輸出檔或資料流。
多載
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
寫入追蹤資訊、訊息,以及事件資訊至檔案或資料流。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
寫入追蹤資訊、格式化的物件陣列,及事件資訊至輸出檔或資料流。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)
寫入追蹤資訊、訊息,以及事件資訊至檔案或資料流。
public:
override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)
參數
- eventCache
- TraceEventCache
TraceEventCache 物件,包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。
- source
- String
用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值,可指定引發追蹤的事件類型。
- id
- Int32
事件的數值識別項。
- message
- String
要寫入輸出檔或資料流的追蹤訊息。
備註
、 eventType
和 id
參數的值source
會寫入為標頭,後面接著message
數據。 數據 eventCache
會寫入為頁尾,其內容取決於 屬性的值 TraceOutputOptions 。
重要
方法 TraceEvent 並非由應用程式程式代碼呼叫。 它會由、 Trace和 TraceSource 類別的方法Debug呼叫,以寫入追蹤數據。
適用於
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])
寫入追蹤資訊、格式化的物件陣列,及事件資訊至輸出檔或資料流。
public:
override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())
參數
- eventCache
- TraceEventCache
TraceEventCache 物件,包含目前處理程序識別碼、執行緒識別碼與堆疊追蹤資訊。
- source
- String
用來識別輸出的名稱,通常是產生追蹤事件的應用程式名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值,可指定引發追蹤的事件類型。
- id
- Int32
事件的數值識別項。
- format
- String
包含零或多個格式項目的格式字串,這些項目與 args
陣列中的物件相對應。
- args
- Object[]
陣列,含有零或多個要格式化的物件。
備註
、 eventType
和 id
參數的值source
會寫入為標頭。 物件 args
陣列會使用 String.Format(String, Object[]) 方法轉換成字串,傳遞 format
字串和 args
數位,將字串格式化為追蹤的訊息部分。 數據 eventCache
會寫入為頁尾,其內容取決於 屬性的值 TraceOutputOptions 。
重要
方法 TraceEvent 並非由應用程式程式代碼呼叫。 它會由、 Trace和 TraceSource 類別的方法Debug呼叫,以寫入追蹤數據。