TraceListener.Filter TraceListener.Filter TraceListener.Filter TraceListener.Filter Property

定義

トレース リスナーのトレース フィルターを取得または設定します。Gets or sets the trace filter for the trace listener.

public:
 property System::Diagnostics::TraceFilter ^ Filter { System::Diagnostics::TraceFilter ^ get(); void set(System::Diagnostics::TraceFilter ^ value); };
[System.Runtime.InteropServices.ComVisible(false)]
public System.Diagnostics.TraceFilter Filter { get; set; }
member this.Filter : System.Diagnostics.TraceFilter with get, set
Public Property Filter As TraceFilter

プロパティ値

TraceFilter 基本クラスから派生したオブジェクト。An object derived from the TraceFilter base class.

Filterプロパティを使用して、ソースフィルターをコンソールトレースリスナーに追加する方法を次のコード例に示します。The following code example shows how to use the Filter property to add a source filter to a console trace listener. このコード例は、 TraceSourceクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the TraceSource class.

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

注釈

トレースフィルターをトレースリスナーに追加することにより、スイッチによってトレースソースに提供されるのではなく、スクリーニングのレイヤーを提供できます。A trace filter can be added to a trace listener to provide a layer of screening beyond that provided to the trace source by switches. たとえば、をトレースEventTypeFilterリスナーに追加して、リスナーによって出力されるイベントの種類を制御できます。For example, the EventTypeFilter can be added to a trace listener to control the event types that are output by the listener. スイッチの条件が満たされているために呼び出されるリスナーは、フィルター (存在する場合) に対してクエリを実行し、トレースを出力に送信するかどうかを判断できます。Listeners that are called because the switch criteria are met can query their filter, if present, to determine if a trace is to be sent to output.

適用対象

こちらもご覧ください