TraceSource.TraceEvent 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

將追蹤事件訊息寫入至 Listeners 集合中的追蹤接聽程式。

多載

TraceEvent(TraceEventType, Int32)	使用指定的事件類型和事件識別碼，將追蹤事件訊息寫入至 Listeners 集合中的追蹤接聽程式。
TraceEvent(TraceEventType, Int32, String)	使用指定的事件類型、事件標識碼和訊息，將追蹤事件訊息寫入 Listeners 集合中的追蹤接聽程式。
TraceEvent(TraceEventType, Int32, String, Object[])	使用指定的事件類型、事件識別碼和自變數陣列和格式，將追蹤事件寫入 Listeners 集合中的追蹤接聽程式。

TraceEvent(TraceEventType, Int32)

來源:

TraceSource.cs

使用指定的事件類型和事件識別碼，將追蹤事件訊息寫入至 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 -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

參數

eventType

TraceEventType

其中一個列舉值，指定追蹤數據的事件類型。

id

Int32

事件的數值標識碼。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

嘗試在完成期間追蹤事件。

範例

下列程式代碼範例示範如何使用 TraceEvent(TraceEventType, Int32) 方法將追蹤事件傳遞至接聽程式。 此程式代碼範例是提供給 TraceSource 類別之較大範例的一部分。

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

備註

TraceEvent 方法旨在追蹤可由工具自動處理的事件。 例如，監視工具可以在特定來源追蹤特定事件時通知系統管理員。

TraceEvent 方法會呼叫 Switch 屬性所傳回之 SourceSwitch 物件的 ShouldTrace 方法。 如果 ShouldTrace 傳回 true，TraceEvent 會呼叫每個接聽程式的對應 TraceEvent 方法。 否則，TraceEvent 傳回而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫方法，則默認輸出會是追蹤來源的名稱、其數值識別和事件類型。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。

注意

EventLogTraceListener 物件限制為 65,535 的最大 id 值。 如果指定的 id 值大於 65,535，EventLogTraceListener 會使用 65,535。

TraceEvent(TraceEventType, Int32, String)

來源:

TraceSource.cs

使用指定的事件類型、事件標識碼和訊息，將追蹤事件訊息寫入 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")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

參數

eventType

TraceEventType

其中一個列舉值，指定追蹤數據的事件類型。

id

Int32

事件的數值標識碼。

message

String

要寫入的追蹤訊息。

屬性

ConditionalAttribute

例外狀況

ObjectDisposedException

嘗試在完成期間追蹤事件。

範例

下列程式代碼範例示範如何使用 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 方法會呼叫 Switch 屬性所傳回之 SourceSwitch 物件的 ShouldTrace 方法。 如果 ShouldTrace 傳回 true，TraceEvent 會呼叫每個接聽程式的對應 TraceEvent 方法。 否則，TraceEvent 傳回而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 如果接聽程式實作未覆寫 方法，默認輸出就是追蹤來源的名稱、其數值識別、事件類型和訊息。 其他追蹤內容取決於接聽程式的 TraceOutputOptions 屬性值。

注意

EventLogTraceListener 物件限制為 65,535 的最大 id 值。 如果指定的 id 值大於 65,535，EventLogTraceListener 物件會使用 65,535。

TraceEvent(TraceEventType, Int32, String, Object[])

來源:

TraceSource.cs

使用指定的事件類型、事件識別碼和自變數陣列和格式，將追蹤事件寫入 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")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public 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 陣列。

屬性

ConditionalAttribute

例外狀況

ArgumentNullException

format null。

FormatException

format 無效。

-或-

數位，表示要格式化的自變數小於零，或大於或等於要格式化的指定物件數目。

ObjectDisposedException

嘗試在完成期間追蹤事件。

範例

下列程式代碼範例示範如何使用 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 方法會呼叫 Switch 屬性所傳回之 SourceSwitch 物件的 ShouldTrace 方法。 如果 ShouldTrace 傳回 true，TraceEvent 會呼叫每個接聽程式的對應 TraceEvent 方法。 否則，TraceEvent 傳回而不呼叫接聽程式的方法。

追蹤內容是特定接聽程式。 默認 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 方法會在追蹤標頭中寫入來源名稱、事件類型和數值識別，然後呼叫 String.Format(IFormatProvider, String, Object[]) 方法、傳遞 format 字串和 args 數位列，並使用 CultureInfo.InvariantCulture 屬性將字元串格式化為訊息輸出。

注意

EventLogTraceListener 物件限制為 65,535 的最大 id 值。 如果指定的 id 值大於 65,535，EventLogTraceListener 物件會使用 65,535。

另請參閱

• 複合格式設定
• 標準數值格式字串
• 自定義數值格式字串
• 標準 DateTime 格式字串
• 自定義 DateTime 格式字串
• 列舉格式字串
• .NET 中的格式設定類型