TraceListener.Filter TraceListener.Filter TraceListener.Filter TraceListener.Filter Property

Определение

Получает или задает фильтр трассировки для прослушивателя трассировки.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

Значение свойства

Объект наследуется из базового класса TraceFilter.An object derived from the TraceFilter base class.

Примеры

В следующем примере кода показано, как использовать Filter свойство добавляемый прослушиватель трассировки консоли Фильтр источника.The following code example shows how to use the Filter property to add a source filter to a console trace listener. Данный пример кода является частью большего примера для 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.")

Комментарии

Создание фильтра трассировки могут добавляться к прослушивателю трассировки для предоставления уровня блокировки, возможности, предоставляемые параметры для источника трассировки.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. Например EventTypeFilter можно добавить прослушиватель трассировки для управления типами событий, создаваемых средством прослушивания.For example, the EventTypeFilter can be added to a trace listener to control the event types that are output by the listener. Прослушиватели, вызываемых тем, что выполняются критерии можно запросить их фильтр, при его наличии, чтобы определить, является ли отправку выходных данных трассировки.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.

Применяется к

Дополнительно