<sharedListeners> 項目

  • 發行項

更新：2007 年 11 月

包含任何來源或追蹤項目可以參考的接聽項。這些接聽項預設不會接收任何追蹤，而且不可能在執行階段擷取這些接聽項。識別為共用接聽項的接聽項可以根據名稱加入到來源或追蹤。

<configuration> 項目
  <system.diagnostics> 項目
    <sharedListeners> 項目

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

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

無

子項目

項目

描述

<trace> 適用之 <listeners> 的 <add> 項目

將接聽項加入至 sharedListeners 集合。

父項目

項目

描述

Configuration

Common Language Runtime 和 .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