EventProviderTraceListener クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
イベントを ETW サブシステムに書き込む TraceSource のリスナーです。
public ref class EventProviderTraceListener : System::Diagnostics::TraceListener
public class EventProviderTraceListener : System.Diagnostics.TraceListener
type EventProviderTraceListener = class
inherit TraceListener
Public Class EventProviderTraceListener
Inherits TraceListener
- 継承
例
private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");
EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");
// You should use the All default level and control the level using the
// ETW session; otherwise, you may not log all the events requested by the
// session.
TraceSource source = new TraceSource("MyProvider", SourceLevels.All);
source.Listeners.Add(listener);
source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });
source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });
source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });
注釈
ソース イベントのすべてのイベント データ (トレースまたはデバッグ) は、文字列として ETW サブシステムに書き込まれます。 データ要素はコンマを使用して区切られます。 別の区切り記号を指定するには、 プロパティを使用します Delimiter 。
リスナーを に追加すると System.Diagnostics.TraceSource 、プロバイダーが ETW サブシステムに登録されます。 イベントをログ ファイルに書き込むには、Logman.exe 実行可能プログラム (または同様のもの) を使用して ETW トレース セッションを作成する必要があります。
イベント データは 1 つの文字列であるため、リスナーからのイベントを使用するためにマニフェストは必要ありません。
メソッドを System.Diagnostics.TraceSource 呼び出してイベントを書き込む場合は、列挙値を System.Diagnostics.TraceEventType 渡します。 列挙には、レベルとキーワード (keyword)の両方の値が含まれています。 ETW セッションからトレース リスナー プロバイダーを有効にする場合、指定するレベル値は、次 System.Diagnostics.TraceEventType のいずれかの列挙値に関連付けられている値になります。
重大 (値は 1)
エラー (値は 2)
情報 (値は 8)
Verbose (値は 16)
警告 (値は 4)
セッションに指定するキーワード (keyword)値には、次System.Diagnostics.TraceEventTypeのいずれかの列挙値に関連付けられている値を指定できます。
Resume (値は 2,048)
Start (値は 256)
Stop (値は 512)
Suspend (値は 1,024)
転送 (値は 4,096)
コンストラクター
EventProviderTraceListener(String) |
指定したプロバイダー識別子を使用して、EventProviderTraceListener クラスの新しいインスタンスを初期化します。 |
EventProviderTraceListener(String, String) |
指定したプロバイダー識別子およびリスナー名を使用して、EventProviderTraceListener クラスの新しいインスタンスを初期化します。 |
EventProviderTraceListener(String, String, String) |
指定したプロバイダー識別子、リスナー名、および区切り記号を使用して、EventProviderTraceListener クラスの新しいインスタンスを初期化します。 |
プロパティ
Attributes |
アプリケーション構成ファイルに定義されているトレース リスナーのカスタム属性を取得します。 (継承元 TraceListener) |
Delimiter |
ETW サブシステムに書き込まれるイベント データの区切りに使用する区切り記号を取得または設定します。 |
Filter |
トレース リスナーのトレース フィルターを取得または設定します。 (継承元 TraceListener) |
IndentLevel |
インデント レベルを取得または設定します。 (継承元 TraceListener) |
IndentSize |
1 つのインデントに含まれるスペースの数を取得または設定します。 (継承元 TraceListener) |
IsThreadSafe |
トレース リスナーがスレッド セーフかどうかを示す値を取得します。 |
Name |
この TraceListener の名前を取得または設定します。 (継承元 TraceListener) |
NeedIndent |
出力にインデントを設定するかどうかを示す値を取得または設定します。 (継承元 TraceListener) |
TraceOutputOptions |
トレース出力オプションを取得または設定します。 (継承元 TraceListener) |
メソッド
Close() |
出力ストリームを終了して、トレース出力またはデバッグ出力を受信しないようにします。 |
CreateObjRef(Type) |
リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject) |
Dispose() |
TraceListener によって使用されているすべてのリソースを解放します。 (継承元 TraceListener) |
Dispose(Boolean) |
TraceListener によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 TraceListener) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
Fail(String) |
TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージを出力します。 (継承元 TraceListener) |
Fail(String, String) |
TraceListener クラスを実装した場合、作成したリスナーにエラー メッセージと詳細エラー メッセージを出力します。 |
Flush() |
出力バッファーをフラッシュします。 |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetLifetimeService() |
古い.
対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
GetSupportedAttributes() |
トレース リスナーによってサポートされるカスタム属性を取得します。 |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
トレース情報、データ オブジェクト、およびイベント情報をリスナー固有の出力に書き込みます。 |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
トレース情報、データ オブジェクト、およびイベント情報をリスナー固有の出力に書き込みます。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
トレース情報およびイベント情報をリスナー固有の出力に書き込みます。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
トレース情報、メッセージ、およびイベント情報をリスナー固有の出力に書き込みます。 |
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
トレース情報、オブジェクトの書式付き配列、およびイベント情報をリスナー固有の出力に書き込みます。 |
TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
トレース情報、メッセージ、関連するアクティビティ ID、およびイベント情報をリスナー固有の出力に書き込みます。 |
Write(Object) |
オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装した時に作成したリスナーに書き込みます。 (継承元 TraceListener) |
Write(Object, String) |
カテゴリ名と、オブジェクトの ToString() メソッドの値を、TraceListener クラスを実装するときに作成したリスナーに書き込みます。 (継承元 TraceListener) |
Write(String) |
派生クラスでオーバーライドした場合、指定したメッセージを派生クラスで作成したリスナーに書き込みます。 |
Write(String, String) |
TraceListener クラスを実装した時に作成したリスナーにカテゴリ名とメッセージを書き込みます。 (継承元 TraceListener) |
WriteIndent() |
このクラスの実装時に作成したリスナーにインデントを書き込み、NeedIndent プロパティを |
WriteLine(Object) |
TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。 (継承元 TraceListener) |
WriteLine(Object, String) |
TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。 (継承元 TraceListener) |
WriteLine(String) |
派生クラスでオーバーライドした場合、派生クラスで作成したリスナーにメッセージと行終端記号を書き込みます。 |
WriteLine(String, String) |
TraceListener クラスの実装時に作成したリスナーにカテゴリ名、メッセージ、および行終端記号を書き込みます。 (継承元 TraceListener) |
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示