共用方式為


<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) 及應用程式設定檔。

範例

下列範例示範如何針對 TraceSourceTrace 使用 <sharedListeners> 元素將接聽程式 console 加入 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>

另請參閱