<clear>源的<listeners><元素>

清除跟踪源的 Listeners 集合。

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

Syntax

<clear/>

特性和元素

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

特性

没有。

子元素

没有。

父元素

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

注解

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

配置文件

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

Example

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

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

另请参阅

• TraceSource
• TraceListener
• 跟踪和调试设置架构
• 跟踪侦听器