TraceListener.Filter Eigenschaft

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

Eigenschaftswert

Ein von der TraceFilter-Basisklasse abgeleitetes Objekt.

Attribute

ComVisibleAttribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die Filter -Eigenschaft verwenden, um einem Konsolen-Ablaufverfolgungslistener einen Quellfilter hinzuzufügen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource-Klasse bereitgestellt wird.

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

Hinweise

Ein Ablaufverfolgungsfilter kann einem Ablaufverfolgungslistener hinzugefügt werden, um eine Überprüfungsebene bereitzustellen, die über die der Ablaufverfolgungsquelle durch Switches hinausgeht. Beispielsweise kann einem EventTypeFilter Ablaufverfolgungslistener hinzugefügt werden, um die Ereignistypen zu steuern, die vom Listener ausgegeben werden. Listener, die aufgerufen werden, weil die Schalterkriterien erfüllt sind, können ihren Filter abfragen, falls vorhanden, um zu bestimmen, ob eine Ablaufverfolgung an die Ausgabe gesendet werden soll.

Gilt für:

Weitere Informationen

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