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

  • 项目

清除跟踪的 Listeners 集合。

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

语法

<clear/>

特性和元素

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

特性

无。

子元素

无。

父元素

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

备注

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

可以通过调用 Trace.Listeners 属性 (System.Diagnostics.Trace.Listeners.Clear()) 的 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>

请参阅