TraceListener.Filter Eigenschaft

Referenz

Definition

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.TraceSource.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest.

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

TraceFilter

Ein von der TraceFilter-Basisklasse abgeleitetes Objekt.

Attribute: ComVisibleAttribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die Filter Eigenschaft verwenden, um einem Konsolenverfolgungslistener 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 Ebene der Überprüfung bereitzustellen, die der Ablaufverfolgungsquelle durch Schalter bereitgestellt wurde. Beispielsweise kann der EventTypeFilter Ablaufverfolgungslistener hinzugefügt werden, um die Ereignistypen zu steuern, die vom Listener ausgegeben werden. Listener, die aufgerufen werden, da die Schalterkriterien erfüllt sind, können ihren Filter abfragen, wenn vorhanden, um festzustellen, ob eine Ablaufverfolgung an die Ausgabe gesendet werden soll.

Gilt für: