TraceListener.Filter Eigenschaft

Definition

Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest.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); };
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.An object derived from the TraceFilter base class.

Attribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mithilfe der- Filter Eigenschaft einen Quell Filter zu einem Konsolen-Ablaufverfolgungslistener hinzufügenThe following code example shows how to use the Filter property to add a source filter to a console trace listener. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die-Klasse bereitgestellt wird 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.")

Hinweise

Ein Ablauf Verfolgungs Filter kann einem Ablaufverfolgungslistener hinzugefügt werden, um eine Ebene der Überprüfung bereitzustellen, die für die Ablauf Verfolgungs Quelle durch die SwitchesA trace filter can be added to a trace listener to provide a layer of screening beyond that provided to the trace source by switches. Beispielsweise kann einem Ablaufverfolgungslistener EventTypeFilter hinzugefügt werden, um die Ereignis Typen zu steuern, die vom Listener ausgegeben werden.For example, the EventTypeFilter can be added to a trace listener to control the event types that are output by the listener. Listener, die aufgerufen werden, weil die Schalter Kriterien erfüllt sind, können ggf. ihren Filter Abfragen, um zu bestimmen, ob eine Ablauf Verfolgung an die Ausgabe gesendet werden soll.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.

Gilt für:

Weitere Informationen