TraceListener.Filter Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает фильтр трассировки для прослушивателя трассировки.
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
Значение свойства
Объект производится из базового класса TraceFilter.
- Атрибуты
Примеры
В следующем примере кода показано, как использовать Filter свойство для добавления исходного фильтра в прослушиватель трассировки консоли. Этот пример входит в состав более крупного примера использования класса 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.")
Комментарии
Фильтр трассировки можно добавить в прослушиватель трассировки, чтобы обеспечить уровень отсева за пределами, предоставляемого источником трассировки с помощью переключателей. Например, EventTypeFilter можно добавить в прослушиватель трассировки для управления типами событий, которые выводятся прослушивателем. Прослушиватели, вызываемые из-за выполнения условий переключения, могут запрашивать фильтр, если он имеется, чтобы определить, следует ли отправлять трассировку в выходные данные.