<sharedListeners> -> <add> -> <filter> 元素

项目
08/18/2008

更新：2007 年 11 月

向 sharedListeners 集合中的侦听器添加筛选器。

<configuration> 元素
   <system.diagnostics> 元素
     <sharedListeners> 元素
       <sharedListeners> 的 <add> 元素
         <sharedListeners> -> <add> -> <filter> 元素

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

属性和元素

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

属性

属性	说明
类型	必选的属性。指定筛选器的类型。可以只使用类型的完整名称（以 Type.FullName 属性的格式），也可以使用包括程序集信息的完全限定的类型名称（以 Type.AssemblyQualifiedName 属性的格式）。有关创建完全限定的类型名称的信息，请参见指定完全限定的类型名称。
initializeData	可选的属性。传递到指定类的构造函数的字符串。

类型

必选的属性。

指定筛选器的类型。可以只使用类型的完整名称（以 Type.FullName 属性的格式），也可以使用包括程序集信息的完全限定的类型名称（以 Type.AssemblyQualifiedName 属性的格式）。有关创建完全限定的类型名称的信息，请参见指定完全限定的类型名称。

initializeData

可选的属性。

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

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics	指定对消息进行收集、存储和路由的跟踪侦听器以及设置跟踪开关的级别。
sharedListeners	任何源或跟踪元素都能引用的侦听器的集合。
add	将侦听器添加到 sharedListeners 集合中。

备注

如果 <sharedListeners> 元素的 <add> 元素中定义了某个侦听器，则应该在属于 <add> 元素的子元素的 <filter> 元素中定义该侦听器的筛选器。

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

示例

下面的示例演示如何使用 <filter> 元素向 sharedListeners 集合中的跟踪侦听器 console 添加筛选器。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>