TraceListener.Filter Propiedad

Definición

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.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); };
[System.Runtime.InteropServices.ComVisible(false)]
public System.Diagnostics.TraceFilter Filter { get; set; }
member this.Filter : System.Diagnostics.TraceFilter with get, set
Public Property Filter As TraceFilter

Valor de propiedad

Un objeto derivado de la clase base TraceFilter.An object derived from the TraceFilter base class.

Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la propiedad Filter para agregar un filtro de origen a un agente de escucha de seguimiento de la consola.The following code example shows how to use the Filter property to add a source filter to a console trace listener. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para la clase 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.")

Comentarios

Se puede Agregar un filtro de seguimiento a un agente de escucha de seguimiento para proporcionar un nivel de filtrado más allá del proporcionado por los modificadores por el origen de seguimiento.A trace filter can be added to a trace listener to provide a layer of screening beyond that provided to the trace source by switches. Por ejemplo, el EventTypeFilter se puede Agregar a un agente de escucha de seguimiento para controlar los tipos de eventos generados por el agente de escucha.For example, the EventTypeFilter can be added to a trace listener to control the event types that are output by the listener. Los agentes de escucha a los que se llama porque se cumplen los criterios del modificador pueden consultar su filtro, si está presente, para determinar si se va a enviar un seguimiento a la salida.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.

Se aplica a

Consulte también: