<source> 的 <listeners> 元素

  • 项目

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

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

语法

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

特性和元素

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

特性

无。

子元素

元素 说明
<add> 将侦听器添加到 Listeners 集合中。
<remove> 从 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>

请参阅