EventSchemaTraceListener.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);
[System.Security.SecurityCritical]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
[<System.Security.SecurityCritical>]
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,包含目前處理序 ID、執行緒 ID 和堆疊追蹤資訊。
- source
- String
來源名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值。
- id
- Int32
事件的數值識別項。
- message
- String
要寫入的訊息。
- 屬性
備註
eventCache
、source
、 eventType
和 id
參數用於追蹤的頁首和頁尾。 參數 id
會在寫入之前轉換為不帶正負號的整數。 因此,負 id
值會寫入為大型正整數。 參數 message
會寫入為 Data
專案中的 EventData
節點。
重要
這個方法不適合直接由應用程式程式代碼呼叫。 它會由、 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);
[System.Security.SecurityCritical]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
[<System.Security.SecurityCritical>]
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,包含目前處理序 ID、執行緒 ID 和堆疊追蹤資訊。
- source
- String
來源名稱。
- eventType
- TraceEventType
其中一個 TraceEventType 值。
- id
- Int32
事件的數值識別項。
- format
- String
包含零或多個格式項目的格式字串,這些項目與 args
陣列中的物件相對應。
- args
- Object[]
物件陣列,包含零或多個要格式化的物件。
- 屬性
備註
eventCache
、source
、 eventType
和 id
參數用於追蹤的頁首和頁尾。 參數 id
會在寫入之前轉換為不帶正負號的整數。 因此,負 id
值會寫入為大型正整數。 系統會 String.Format(String, Object[]) 呼叫 方法, format
並以參數的形式傳入字串和 args
陣列。 這個方法會 args
格式化物件數位,並將格式化的數位寫入為 Data
專案中的 EventData
節點。
重要
這個方法不適合直接由應用程式程式代碼呼叫。 它會由、 Trace和 TraceSource 類別的方法Debug呼叫,以寫入追蹤數據。