TraceListener.Filter Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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; }
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
Valeur de propriété
Objet dérivé de la classe de base TraceFilter.
- Attributs
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.