<trace><listeners><add> 的 <filter> 元素

将筛选器添加到跟踪的 Listeners 集合中的侦听器。

configuration
  <system.diagnostics>
    <trace>
      <listeners>
        <add>
          <filter>

语法

<filter
  type="traceFilterClassName"
  initializeData="data" />  

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
type 必需的特性。

指定筛选器的类型,该类型应继承自 TraceFilter 类。 你可以使用类型的命名空间限定名称,该名称与类型的 FullName 属性相对应,或者你可以使用包含程序集信息(与 AssemblyQualifiedName 属性相对应)的完全限定的类型名称。 有关完全限定的类型名称的信息,请参阅指定完全限定的类型名称
initializeData 可选特性。

传递给指定筛选器类的构造函数的字符串。

子元素

无。

父元素

元素 说明
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics 指定用于收集、存储和路由消息的跟踪侦听器以及对跟踪开关设置的级别。
trace 包含用于收集、存储和路由跟踪消息的侦听器。
listeners 包含用于收集、存储和路由跟踪消息的侦听器。 侦听器将跟踪输出定向到相应的目标。
add 将侦听器添加到 Listeners 集合中。

备注

<filter> 元素必须包含在指定侦听器类型的跟踪侦听器的 <add> 元素中,而不只是包含在 <sharedListeners> 定义的侦听器名称中。 如果侦听器是在 <sharedListeners> 中定义的,则必须在该元素中定义该侦听器的筛选器。

此元素可在计算机配置文件 (Machine.config) 和应用程序配置文件中使用。

示例

以下示例演示如何使用 <filter> 元素将筛选器添加到跟踪的 Listeners 集合中的侦听器 console,并将筛选器事件级别指定为 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>  

请参阅