TraceSource.TraceEvent 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
多載
| TraceEvent(TraceEventType, Int32) |
使用指定的事件類型和事件識別項，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。 |
| TraceEvent(TraceEventType, Int32, String) |
使用指定的事件類型、事件識別項和訊息，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。 |
| TraceEvent(TraceEventType, Int32, String, Object[]) |
使用指定的事件類型、事件識別項和引數陣列與格式，將追蹤事件寫入 Listeners 集合中的追蹤接聽程式。 |
TraceEvent(TraceEventType, Int32)
使用指定的事件類型和事件識別項，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer)參數
- eventType
- TraceEventType
其中一個列舉值，可指定追蹤資料的事件類型。
- id
- Int32
事件的數值識別項。
- 屬性
例外狀況
嘗試在最終處理期間追蹤事件。
範例
下列程式碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式碼範例是提供給 類別之較大範例的 TraceSource 一部分。
ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)
備註
方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。
方法 TraceEvent 會 ShouldTrace 呼叫 屬性所 Switch 傳回之 物件的 方法 SourceSwitch 。 如果 ShouldTrace 傳 true 回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。
追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫方法，則預設輸出會是追蹤來源的名稱、其數值識別和事件種類。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。
注意
物件 EventLogTraceListener 限制為最大值 id 65，535。 id如果指定的值大於 65，535，則 EventLogTraceListener 會使用 65，535。
適用於
TraceEvent(TraceEventType, Int32, String)
使用指定的事件類型、事件識別項和訊息，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)參數
- eventType
- TraceEventType
其中一個列舉值，可指定追蹤資料的事件類型。
- id
- Int32
事件的數值識別項。
- message
- String
要寫入的追蹤訊息。
- 屬性
例外狀況
嘗試在最終處理期間追蹤事件。
範例
下列程式碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式碼範例是提供給 類別之較大範例的 TraceSource 一部分。
// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")
備註
方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。
方法 TraceEvent 會 ShouldTrace 呼叫 屬性所 Switch 傳回之 物件的 方法 SourceSwitch 。 如果 ShouldTrace 傳 true 回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。
追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫方法，預設輸出會是追蹤來源的名稱、其數值識別、事件種類和訊息。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。
注意
物件 EventLogTraceListener 限制為最大值 id 65，535。 id如果指定的值大於 65，535，則 EventLogTraceListener 物件會使用 65，535。
適用於
TraceEvent(TraceEventType, Int32, String, Object[])
使用指定的事件類型、事件識別項和引數陣列與格式，將追蹤事件寫入 Listeners 集合中的追蹤接聽程式。
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unitPublic Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())參數
- eventType
- TraceEventType
其中一個列舉值，可指定追蹤資料的事件類型。
- id
- Int32
事件的數值識別項。
- format
- String
複合格式字串，其中包含混合零或多個格式項目的文字，並與 args 陣列中的物件相對應。
- args
- Object[]
object 陣列，含有零或多個要格式化的物件。
- 屬性
例外狀況
format 為 null。
嘗試在最終處理期間追蹤事件。
範例
下列程式碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式碼範例是提供給 類別之較大範例的 TraceSource 一部分。
// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")
備註
如需 參數的詳細資訊 format ，請參閱 複合格式設定。
方法 TraceEvent 旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。
方法 TraceEvent 會 ShouldTrace 呼叫 屬性所 Switch 傳回之 物件的 方法 SourceSwitch 。 如果 ShouldTrace 傳 true 回 ， TraceEvent 則呼叫每個接聽程式的對應 TraceEvent 方法。 否則會 TraceEvent 傳回 ，而不呼叫接聽程式的方法。
追蹤內容是特定接聽程式。 預設 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 方法會在追蹤標頭中寫入來源名稱、事件種類和數值識別，然後呼叫 String.Format(IFormatProvider, String, Object[]) 方法、傳遞 format 字串和 args 陣列，並使用 CultureInfo.InvariantCulture 屬性將字串格式化為訊息輸出。
注意
物件 EventLogTraceListener 限制為最大值 id 65，535。 id如果指定的值大於 65，535，則 EventLogTraceListener 物件會使用 65，535。