TraceListener.Filter プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
トレース リスナーのトレース フィルターを取得または設定します。
public:
property System::Diagnostics::TraceFilter ^ Filter { System::Diagnostics::TraceFilter ^ get(); void set(System::Diagnostics::TraceFilter ^ value); };public System.Diagnostics.TraceFilter? Filter { get; set; }public System.Diagnostics.TraceFilter Filter { get; set; }[System.Runtime.InteropServices.ComVisible(false)]
public System.Diagnostics.TraceFilter Filter { get; set; }member this.Filter : System.Diagnostics.TraceFilter with get, set[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Filter : System.Diagnostics.TraceFilter with get, setPublic Property Filter As TraceFilterプロパティ値
TraceFilter 基本クラスから派生したオブジェクト。
- 属性
例
次のコード例は、このプロパティを使用 Filter して、ソース フィルターをコンソール トレース リスナーに追加する方法を示しています。 このコード例は、TraceSource クラスのために提供されている大規模な例の一部です。
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
注釈
トレース フィルターをトレース リスナーに追加して、スイッチによってトレース ソースに提供される以上のスクリーニングレイヤーを提供できます。 たとえば、 EventTypeFilter トレース リスナーに追加して、リスナーによって出力されるイベントの種類を制御できます。 スイッチ条件が満たされているために呼び出されるリスナーは、フィルター (存在する場合) を照会して、トレースを出力に送信するかどうかを判断できます。