TraceListener.Filter Właściwość

Definicja

Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia.

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

Wartość właściwości

Obiekt pochodzący z klasy bazowej TraceFilter .

Atrybuty

Przykłady

Poniższy przykład kodu przedstawia sposób użycia właściwości w celu dodania filtru Filter źródłowego do odbiornika śledzenia konsoli. Ten przykład kodu jest częścią większego przykładu udostępnionego TraceSource dla klasy .

// 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.")

Uwagi

Filtr śledzenia można dodać do odbiornika śledzenia, aby zapewnić warstwę osłony wykraczającą poza źródło śledzenia przez przełączniki. Można na przykład dodać element EventTypeFilter do odbiornika śledzenia w celu kontrolowania typów zdarzeń, które są wyjściowe przez odbiornik. Odbiorniki, które są wywoływane, ponieważ kryteria przełącznika są spełnione, mogą wysyłać zapytania do filtru, jeśli istnieje, aby określić, czy śledzenie ma być wysyłane do danych wyjściowych.

Dotyczy

Zobacz też