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

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

id

Int32

イベントの数値識別子。

属性

ConditionalAttribute

例外

ObjectDisposedException

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

例

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

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

注釈

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

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

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

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定された 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

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

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

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

注意

オブジェクトの EventLogTraceListener 最大値 id は 65,535 に制限されています。 指定された 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

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

id

Int32

イベントの数値識別子。

format

String

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

args

Object[]

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

属性

ConditionalAttribute

例外

ArgumentNullException

format が nullです。

FormatException

format が無効です。

- または -

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

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 、 ShouldTrace プロパティによって返されるオブジェクトの SourceSwitch メソッドを Switch 呼び出します。 が を返す場合ShouldTraceはtrueTraceEvent、各リスナーの対応する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 を使用します。

こちらもご覧ください

• 複合書式指定
• 標準の数値書式指定文字列
• カスタム数値形式文字列
• 標準の DateTime 書式指定文字列
• カスタム DateTime 書式指定文字列
• Enumeration Format Strings
• .NET での型の書式設定