TraceListener.Filter 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置跟踪侦听器的跟踪筛选器。
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 可以将 添加到跟踪侦听器,以控制侦听器输出的事件类型。 由于满足切换条件而调用的侦听器可以查询其筛选器(如果存在),以确定是否将跟踪发送到输出。