次の方法で共有


TraceSource.TraceEvent メソッド

定義

トレース イベント メッセージを Listeners コレクションのトレース リスナーに書き込みます。

オーバーロード

TraceEvent(TraceEventType, Int32)

指定されたイベントの種類およびイベント識別子を使用して、トレース イベント メッセージを Listeners コレクション内のトレース リスナーに書き込みます。

TraceEvent(TraceEventType, Int32, String)

指定されたイベントの種類、イベント識別子、およびメッセージを使用して、トレース イベント メッセージを Listeners コレクション内のトレース リスナーに書き込みます。

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

指定されたイベントの種類、イベント識別子、および引数配列と書式設定を使用して、トレース イベントを Listeners コレクション内のトレース リスナーに書き込みます。

TraceEvent(TraceEventType, Int32)

ソース:
TraceSource.cs
ソース:
TraceSource.cs
ソース:
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

トレース データのイベントの種類を指定する列挙値の 1 つ。

id
Int32

イベントの数値識別子。

属性

例外

終了処理時にイベントをトレースしようとしました。

次のコード例は、 メソッドを TraceEvent(TraceEventType, Int32) 使用してトレース イベントをリスナーに渡す方法を示しています。 このコード例は、TraceSource クラスのために提供されている大規模な例の一部です。

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

注釈

メソッドは TraceEvent 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。

メソッドは TraceEventShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTracetrueTraceEvent、各リスナーの対応するTraceEventメソッドを呼び出します。 それ以外の場合は、 TraceEvent はリスナーのメソッドを呼び出さずに を返します。

トレースコンテンツはリスナー固有です。 メソッドがリスナーの実装によってオーバーライドされない場合、既定の出力はトレース ソースの名前、その数値 ID、およびイベントの種類です。 追加のトレース コンテンツは、リスナーの TraceOutputOptions プロパティ値に依存します。

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定された id 値が 65,535 より大きい場合、 EventLogTraceListener では 65,535 が使用されます。

適用対象

TraceEvent(TraceEventType, Int32, String)

ソース:
TraceSource.cs
ソース:
TraceSource.cs
ソース:
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")]
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

トレース データのイベントの種類を指定する列挙値の 1 つ。

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 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。

メソッドは TraceEventShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTracetrueTraceEvent、各リスナーの対応するTraceEventメソッドを呼び出します。 それ以外の場合は、 TraceEvent はリスナーのメソッドを呼び出さずに を返します。

トレースコンテンツはリスナー固有です。 メソッドがリスナーの実装によってオーバーライドされない場合、既定の出力はトレース ソースの名前、その数値 ID、イベントの種類、およびメッセージです。 追加のトレース コンテンツは、リスナーの TraceOutputOptions プロパティ値に依存します。

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定された id 値が 65,535 より大きい場合、 EventLogTraceListener オブジェクトは 65,535 を使用します。

適用対象

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

ソース:
TraceSource.cs
ソース:
TraceSource.cs
ソース:
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")]
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[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

パラメーター

eventType
TraceEventType

トレース データのイベントの種類を指定する列挙値の 1 つ。

id
Int32

イベントの数値識別子。

format
String

0 個以上の書式項目が混在したテキストを含む複合書式指定文字列。各書式項目は、args 配列内のオブジェクトに対応します。

args
Object[]

0 個以上の書式設定対象オブジェクトを含んだ object 配列。

属性

例外

formatnullです。

format が無効です。

- または -

書式設定する引数を示す数が 0 より小さいか、書式設定する指定されたオブジェクトの数以上です。

終了処理時にイベントをトレースしようとしました。

次のコード例は、 メソッドを 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 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。

メソッドは TraceEventShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTracetrueTraceEvent、各リスナーの対応するTraceEventメソッドを呼び出します。 それ以外の場合は、 TraceEvent はリスナーのメソッドを呼び出さずに を返します。

トレースコンテンツはリスナー固有です。 既定TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])のメソッドは、ソース名、イベントの種類、および数値 ID をトレース ヘッダーに書き込み、 メソッドをString.Format(IFormatProvider, String, Object[])呼び出し、文字列とargs配列をformat渡し、 プロパティをCultureInfo.InvariantCulture使用して文字列をメッセージ出力として書式設定します。

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定された id 値が 65,535 より大きい場合、 EventLogTraceListener オブジェクトは 65,535 を使用します。

こちらもご覧ください

適用対象