<sharedListeners> 元素

  • 發行項

包含任何來源或追蹤項目可參考的接聽項。 這些接聽程式預設不會收到任何追蹤，而且無法在執行時間擷取這些接聽程式。 識別為共用接聽程式的接聽程式可依名稱加入來源或追蹤。

<configuration>
  <system.diagnostics>
    <sharedListeners>

Syntax

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

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

無。

子元素

元素 描述
<add> 將接聽項新增至 sharedListeners 集合。

父項目

元素 Description
Configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定 ASP.NET 組態區段的根項目。

備註

將接聽程式新增至共用接聽程式集合，並不會使其成為使用中的接聽程式。 這仍必須新增至追蹤來源或追蹤，方法是加入至該追蹤專案的 Listeners 集合。 .NET Framework中的接聽程式類別衍生自 TraceListener 類別。

這個元素可用於機器設定檔 (Machine.config) 及應用程式設定檔。

範例

下列範例示範如何針對 TraceSource 和 Trace 使用 <sharedListeners> 元素將接聽程式 console 加入 Listeners 集合。 主控台追蹤接聽程式會透過對 TraceSource 或 Trace 的呼叫，將追蹤資訊寫入主控台。

<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>

另請參閱