TraceListener.Filter 屬性

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

來源:

TraceListener.cs

取得或設定追蹤接聽程式的追蹤篩選。

public:
 property System::Diagnostics::TraceFilter ^ Filter { System::Diagnostics::TraceFilter ^ get(); void set(System::Diagnostics::TraceFilter ^ value); };

public System.Diagnostics.TraceFilter? Filter { get; set; }

member this.Filter : System.Diagnostics.TraceFilter with get, set

Public Property Filter As TraceFilter

屬性值

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 可以新增至追蹤接聽程式，以控制接聽程式所輸出的事件類型。 因為符合參數準則而呼叫的接聽程式可以查詢其篩選條件，如果有的話，即可判斷追蹤是否要傳送至輸出。

另請參閱

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TextWriterTraceListener
• Debug
• Trace