通过


<filter> <add> <sharedListeners 的元素>

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

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add>
        <filter>

Syntax

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

特性和元素

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

特性

Attribute Description
类型 必需属性。

指定筛选器的类型。 只能使用类型的全名(以属性的格式 Type.FullName ),也可以使用完全限定的类型名称,包括程序集信息(以属性的格式 Type.AssemblyQualifiedName )。 有关创建完全限定类型名称的信息,请参阅 “指定完全限定的类型名称”。
initializeData 可选属性。

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

子元素

没有。

父元素

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

注解

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

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

Example

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

<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>

另请参阅