TraceSource.TraceEvent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
指定されたイベントの種類およびイベント識別子を使用して、トレース イベント メッセージを 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
トレース データのイベントの種類を指定する列挙値の 1 つ。
- id
- Int32
イベントの数値識別子。
- 属性
例外
終了処理時にイベントをトレースしようとしました。
例
次のコード例は、 メソッドを 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
- ソース:
- 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 -> unitPublic 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 、ツールによって自動的に処理できるイベントをトレースすることを目的としています。 たとえば、監視ツールは、特定のイベントが特定のソースによってトレースされた場合に管理者に通知できます。
メソッドは 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
- ソース:
- 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[] -> unitPublic 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 配列。
- 属性
例外
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 プロパティによって返されるオブジェクトの 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 での型の書式設定
適用対象
.NET