TraceListener.Filter Propiedad

Referencia

Definición

Espacio de nombres:: System.Diagnostics

Ensamblado:: System.Diagnostics.TraceSource.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.

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

Valor de propiedad

TraceFilter

Un objeto derivado de la clase base TraceFilter.

Atributos: ComVisibleAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la Filter propiedad para agregar un filtro de origen a un agente de escucha de seguimiento de consola. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase TraceSource.

// 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 una capa de filtrado más allá de la proporcionada al origen de seguimiento por modificadores. Por ejemplo, EventTypeFilter se puede agregar a un agente de escucha de seguimiento para controlar los tipos de eventos que genera el agente de escucha. Los agentes de escucha a los que se llama porque se cumplen los criterios de modificador pueden consultar su filtro, si está presente, para determinar si se va a enviar un seguimiento a la salida.

Se aplica a