EventProviderTraceListener クラス

リファレンス

定義

名前空間:: System.Diagnostics.Eventing

アセンブリ:: System.Core.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object

MarshalByRefObject

TraceListener
EventProviderTraceListener

例

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 渡します。列挙には、レベル値とキーワード値の両方が含まれます。 ETW セッションからトレースリスナープロバイダーを有効にする場合、指定するレベル値は、次 System.Diagnostics.TraceEventType のいずれかの列挙値に関連付けられている値にすることができます。

クリティカル (値は 1)
エラー (値は 2)
情報 (値は 8)
Verbose (値は 16)
警告 (値は 4)

セッションに指定するキーワード値には、次 System.Diagnostics.TraceEventType のいずれかの列挙値に関連付けられた値を指定できます。

Resume (値は 2,048)
開始 (値は 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 プロパティを `false` にリセットします。 (継承元 TraceListener)
WriteLine(Object)	TraceListener クラスの実装時に作成したリスナーにオブジェクトの ToString() メソッドの値と行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(Object, String)	TraceListener クラスの実装時に作成したリスナーにカテゴリ名、オブジェクトの ToString() メソッドの値、および行終端記号を書き込みます。 (継承元 TraceListener)
WriteLine(String)	派生クラスでオーバーライドした場合、派生クラスで作成したリスナーにメッセージと行終端記号を書き込みます。
WriteLine(String, String)	TraceListener クラスの実装時に作成したリスナーにカテゴリ名、メッセージ、および行終端記号を書き込みます。 (継承元 TraceListener)

適用対象

こちらもご覧ください

TraceListener