<sharedListeners> 元素

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

configuration
  <system.diagnostics>
    <sharedListeners>

语法

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

特性和元素

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

特性

无。

子元素

元素 说明
<add> 将侦听器添加到 sharedListeners 集合中。

父元素

元素 说明
Configuration 公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.diagnostics 为 ASP.NET 配置节指定根元素。

备注

将侦听器添加到共享侦听器集合不会使其成为活动侦听器。 仍然必须通过将其添加到该跟踪元素的 Listeners 集合中,从而将其添加到跟踪源或跟踪。 .NET Framework 中的侦听器类派生自 TraceListener 类。

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

示例

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

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

请参阅