TraceListener.Filter 属性

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

TraceListener.cs

获取或设置跟踪侦听器的跟踪筛选器。

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

属性值

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 可以将 添加到跟踪侦听器，以控制侦听器输出的事件类型。 由于满足切换条件而调用的侦听器可以查询其筛选器（如果存在），以确定是否将跟踪发送到输出。

另请参阅

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