<source><listeners> 的 <clear> 元素

  • 项目

清除跟踪源的 Listeners 集合。

configuration
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <clear>

语法

<clear/>

特性和元素

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

特性

无。

子元素

无。

父元素

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

备注

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

配置文件

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

示例

下面的示例演示在使用 <add> 元素将侦听器 console 和 textListener 添加到跟踪源 TraceSourceApp 的 Listeners 集合之前，如何使用 <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>

请参阅