<source> -> <listeners> -> <remove> 元素

项目
09/04/2008

更新：2007 年 11 月

从跟踪源的 Listeners 集合中移除侦听器。

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

<remove name="listenerName" />

属性和元素

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

属性

属性	说明
name	必选的属性。要从 Listeners 集合中移除的侦听器的名称。

子元素

无。

父元素

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

备注

<remove> 元素从跟踪源的 Listeners 集合中移除指定的侦听器。

通过调用 TraceSource 实例的 Listeners 属性上的 Remove 方法，可以以编程方式从跟踪源的 Listeners 集合中移除元素。

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

示例

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

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>