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