TraceSource.TraceEvent メソッド

定義

名前空間:: System.Diagnostics

アセンブリ:: netstandard.dll, System.Diagnostics.TraceSource.dll

アセンブリ:: System.Diagnostics.TraceSource.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

イベントの数値識別子。

属性: ConditionalAttribute

例外

ObjectDisposedException

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

例

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

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

注釈

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

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

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

Note

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

適用対象

TraceEvent(TraceEventType, Int32, String)

ソース:: TraceSource.cs

ソース:: TraceSource.cs

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

書き込むトレースメッセージ。

属性: ConditionalAttribute

例外

ObjectDisposedException

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

例

// 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")

注釈

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

Note

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

適用対象

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

ソース:: TraceSource.cs

ソース:: TraceSource.cs

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

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

args: Object[]

書式設定する 0 個以上のオブジェクトを含む object 配列。

属性: ConditionalAttribute

例外

ArgumentNullException

format は nullです。

FormatException

format が無効です。

-又は-

書式設定する引数が 0 未満、または書式設定する指定したオブジェクトの数以上であることを示す数値。

ObjectDisposedException

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

例

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

Note

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?