<trace> 的 <listeners> 的 <clear> 元素

项目
08/12/2011

清除跟踪的 Listeners 集合。

<clear/>

特性和元素

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

特性

无。

子元素

无。

父元素

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

备注

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

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

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

注意
<clear> 元素从 Listeners 集合中移除 DefaultTraceListener，更改 Debug.Assert、Trace.Assert、Debug.Fail 和 Trace.Fail 方法的行为。调用 Assert 或 Fail 方法通常会显示一个消息框。但是，如果 DefaultTraceListener 不在 Listeners 集合中，则不会显示消息框。

示例

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

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