<sharedListeners> 元素

  • 项目

更新：2007 年 11 月

包含任何源或跟踪元素都能引用的侦听器。这些侦听器默认不接收任何跟踪，并且也不可能在运行时检索这些侦听器。标识为共享侦听器的侦听器可按名称添加到源或跟踪。

<configuration> 元素
  <system.diagnostics> 元素
    <sharedListeners> 元素

<sharedListeners> 
  <add>...</add>
</sharedListeners>

属性和元素

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

属性

无。

子元素

元素

说明

<trace> -> <listeners> -> <add> 元素

将侦听器添加到 sharedListeners 集合中。

父元素

元素

说明

Configuration

公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

system.diagnostics

为 ASP.NET 配置节指定根元素。

备注

向共享侦听器集合添加侦听器不会使它成为活动侦听器。仍需将它添加到跟踪源或跟踪，方法是将它添加到跟踪元素的 Listeners 集合。.NET Framework 中的侦听器类从 TraceListener 类派生。

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

示例

下面的示例演示如何使用 <sharedListeners> 元素将侦听器 console 添加到 TraceSource 和 Trace 类的 Listeners 集合中。控制台跟踪侦听器通过调用 TraceSource 或 Trace 将跟踪信息写到控制台。

<system.diagnostics>
  <sources>
    <source name="mySource" switchName="sourceSwitch value="Verbose" >
      <listeners>
        <add name="console" />
      </listeners>
    </source>
  </sources>  
  <sharedListeners>    <add name="console" type="System.Diagnostics.ConsoleTraceListener" >      <filter type="System.Diagnostics.EventTypeFilter"         initializeData="Warning" />    </add>  </sharedListeners>
  <trace>
    <listeners>
      <add name="console" />
    </listeners>
  </trace>
</system.diagnostics>

请参见

概念

跟踪侦听器

参考

跟踪和调试设置架构

TraceListener