<source> 的 <listeners> 元素

更新：2007 年 11 月

在 TraceSource 的 Listeners 集合中添加或移除侦听器。侦听器会将跟踪输出定向到适当的目标，如日志、窗口或文本文件。

<configuration> 元素
  <system.diagnostics> 元素
    <sources> 元素
      <source> 元素
        <source> 的 <listeners> 元素

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

属性和元素

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

属性

无。

子元素

元素	说明
<source> -> <listeners> -> <add> 元素	将侦听器添加到 Listeners 集合中。
<source> -> <listeners> -> <remove> 元素	从 Listeners 集合中移除侦听器。
<source> -> <listeners> -> <clear> 元素	清除跟踪源的 Listeners 集合。

父元素

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

备注

配置文件

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

示例

下面的示例演示如何使用 <listeners> 元素将控制台跟踪侦听器添加到 mySource 源并移除默认跟踪侦听器。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

请参见

概念

跟踪侦听器

参考

跟踪和调试设置架构

TraceListener