<clear>用于跟踪的<listeners><元素>

清除用于跟踪的 Listeners 集合。

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <clear>

Syntax

<clear/>

特性和元素

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

特性

没有。

子元素

没有。

父元素

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

注解

该 <clear> 元素从 Listeners 集合中删除用于跟踪的所有侦听器。 在使用元素之前<clear>，可以使用<add>该元素来确定集合中没有其他活动侦听器。

可以通过对属性调用ListenersClear方法Trace.Listeners（）以编程方式清除System.Diagnostics.Trace.Listeners.Clear()集合。

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

注释

该元素从集合中删除该元素，并更改了 /> 和方法的行为。 调用或AssertFail方法通常会导致显示消息框。 但是，如果未 DefaultTraceListener 在集合中 Listeners ，则不显示消息框。

Example

以下示例演示如何在<clear>使用该元素将侦听器<add>添加到console集合中以跟踪之前使用Listeners元素。

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <clear/>
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />
        </add>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

另请参阅

• Listeners
• Trace
• Debug
• TraceSource
• 跟踪和调试设置架构
• <删除>
• 跟踪侦听器