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

项目
08/12/2011

向跟踪源的 Listeners 集合中的侦听器添加筛选器。

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

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性	说明
type	必选特性。指定筛选器的类型，该类型应该从 TraceFilter 类继承。可以使用以命名空间限定的类型名称，它对应于类型的 FullName 属性，或者可以使用包括程序集信息的完全限定的类型名称，它对应于 AssemblyQualifiedName 属性。有关完全限定的类型名称的信息，请参见指定完全限定的类型名称。
initializeData	可选特性。传递到指定筛选类的构造函数的字符串。

type

必选特性。

指定筛选器的类型，该类型应该从 TraceFilter 类继承。可以使用以命名空间限定的类型名称，它对应于类型的 FullName 属性，或者可以使用包括程序集信息的完全限定的类型名称，它对应于 AssemblyQualifiedName 属性。有关完全限定的类型名称的信息，请参见指定完全限定的类型名称。

initializeData

可选特性。

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

子元素

无。

父元素

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

备注

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

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

示例

下面的示例演示如何使用 <filter> 元素向跟踪源 myTraceSource 的 Listeners 集合中的侦听器 console 添加筛选器，并将筛选器事件级别指定为 Error。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" switchName="SourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch"  >
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener" >
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error" />
          </add>
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="SourceSwitch" value="Warning" />
    </switches>
  </system.diagnostics>
</configuration>