将筛选器添加到集合中的 Listeners 侦听器以用于跟踪。
<configuration>
<system.diagnostics>
<trace>
<listeners>
<add>
<filter>
Syntax
<filter
type="traceFilterClassName"
initializeData="data" />
特性和元素
下列各节描述了特性、子元素和父元素。
特性
| Attribute | Description |
|---|---|
type |
必需属性。 指定应从 TraceFilter 类继承的筛选器的类型。 可以使用类型（对应于类型 FullName 属性）的命名空间限定名称，也可以使用完全限定的类型名称，包括与该属性对应的 AssemblyQualifiedName 程序集信息。 有关完全限定的类型名称的信息，请参阅 指定完全限定的类型名称。 |
initializeData |
可选属性。 传递给指定筛选器类的构造函数的字符串。 |
子元素
没有。
父元素
| 元素 | Description |
|---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.diagnostics |
指定收集、存储和路由消息的跟踪侦听器以及设置跟踪开关的级别。 |
trace |
包含收集、存储和路由跟踪消息的侦听器。 |
listeners |
包含收集、存储和路由消息的侦听器。 侦听器将跟踪输出定向到适当的目标。 |
add |
将侦听器添加到 Listeners 集合。 |
注解
该<filter>元素必须包含在跟踪侦听器的元素中<add>，该侦听器指定侦听器的类型，而不仅仅是在 sharedListeners< 中>定义的侦听器的名称。 如果在 sharedListeners< 中>定义了侦听器，则必须在该元素中定义该侦听器的筛选器。
此元素可用于计算机配置文件（Machine.config）和应用程序配置文件。
Example
以下示例演示如何使用<filter>元素将筛选器添加到集合中的console侦听器Listeners进行跟踪，并将筛选器事件级别指定为 Error。
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error" />
</add>
<remove name="Default" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
