TraceListener.Filter Propriedade

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Origem:

TraceListener.cs

Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento.

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

Valor da propriedade

TraceFilter

Um objeto derivado da classe base TraceFilter.

Exemplos

O exemplo de código a seguir mostra como usar a propriedade para adicionar um filtro de origem Filter a um ouvinte de rastreamento do console. Este exemplo de código faz parte de um exemplo maior fornecido para a 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.")

Comentários

Um filtro de rastreamento pode ser adicionado a um ouvinte de rastreamento para fornecer uma camada de triagem além daquela fornecida à fonte de rastreamento por comutadores. Por exemplo, o EventTypeFilter pode ser adicionado a um ouvinte de rastreamento para controlar os tipos de evento que são gerados pelo ouvinte. Os ouvintes que são chamados porque os critérios de opção são atendidos podem consultar seu filtro, se presente, para determinar se um rastreamento deve ser enviado para a saída.

Confira também

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