<source> -> <listeners> -> <clear> 元素

项目
08/18/2008

更新：2007 年 11 月

清除跟踪源的 Listeners 集合。

<configuration> 元素
   <system.diagnostics> 元素
     <sources> 元素
       <source> 元素
         <trace> -> <listeners> 元素
           <source> -> <listeners> -> <clear> 元素

<clear/>

属性和元素

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

属性

无。

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics	指定对消息进行收集、存储和路由的跟踪侦听器以及设置跟踪开关的级别。
sources	包含启动跟踪消息的跟踪源。
source	指定启动跟踪消息的跟踪源。
listeners	指定对消息进行收集、存储和路由的侦听器。

备注

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

配置文件

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

示例

下面的示例演示如何在使用 <add> 元素向跟踪源 TraceSourceApp 的 Listeners 集合中添加侦听器 console 和 textListener 之前使用 <clear> 元素。

<configuration>
  <system.diagnostics>
    <sources>
       <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>