TraceListener.Filter Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Source:

TraceListener.cs

Obtient ou définit le filtre de trace pour l’écouteur de la trace.

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

Valeur de propriété

TraceFilter

Objet dérivé de la classe de base TraceFilter.

Exemples

L’exemple de code suivant montre comment utiliser la Filter propriété pour ajouter un filtre source à un écouteur de trace de console. Cet exemple de code fait partie d’un exemple plus grand fourni pour la TraceSource classe .

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

Remarques

Un filtre de trace peut être ajouté à un écouteur de suivi pour fournir une couche de filtrage au-delà de celle fournie à la source de trace par les commutateurs. Par exemple, le EventTypeFilter peut être ajouté à un écouteur de suivi pour contrôler les types d’événements qui sont générés par l’écouteur. Les écouteurs appelés parce que les critères de commutateur sont remplis peuvent interroger leur filtre, le cas échéant, pour déterminer si une trace doit être envoyée à la sortie.

Voir aussi

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