<sharedListeners> 元素

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

<configuration><system.diagnostics><sharedListeners>

Syntax

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

特性和元素

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

特性

没有。

子元素

父元素

注解

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

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

Example

以下示例演示如何使用 <sharedListeners> 元素将侦听器 console 添加到 Listeners 集合中的 TraceSource 侦听器和 Trace 类。 控制台跟踪侦听器通过调用或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>

另请参阅

• TraceListener
• 跟踪和调试设置架构
• 跟踪侦听器