<><add> 的 <filter> 元素

  • 项目

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

<配置>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

语法

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

特性和元素

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

特性

属性 说明
type 必需的特性。

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

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

子元素

无。

父元素

元素 说明
configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics 指定用于收集、存储和路由消息的跟踪侦听器以及对跟踪开关设置的级别。
sharedListeners 任何 source 或 trace 元素都可以引用的侦听器的集合。
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>

另请参阅