<為來源的<<接聽程式>新增>元素>

  • 發行項

將接聽項新增至追蹤來源的 Listeners 集合。

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <add>

語法

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"/>

屬性和項目

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

屬性

屬性 描述
type 必要屬性，除非您在集合中 sharedListeners 參考接聽程式，在此情況下，您只需要依名稱參考它（請參閱 範例）。

指定接聽程式的型別。 您必須使用符合指定完整類型名稱中所指定需求的字串。
initializeData 選用屬性。

傳遞至指定類別之建構函式的字串。 ConfigurationException如果類別沒有接受字串的建構函式，則會擲回 。
name 選用屬性。

指定接聽程序的名稱。
traceOutputOptions 選用屬性。

指定 TraceOutputOptions 追蹤接聽程序的屬性值。
[自定義屬性] 選擇性屬性。

指定該接聽程式之 方法所 GetSupportedAttributes 識別之接聽程式特定屬性的值。 Delimiter 是類別唯 DelimitedListTraceListener 一的額外屬性範例。

子元素

元素 描述
<filter> 將篩選新增至追蹤來源之 Listeners 集合中的接聽項。

父項目

元素 描述
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。
sources 包含起始追蹤訊息的追蹤來源。
source 指定起始追蹤訊息的追蹤來源。
listeners 指定收集、儲存和路由訊息的接聽程式。

備註

隨附於 .NET Framework 的接聽程序類別衍生自 TraceListener 類別。

如果您未指定 name 追蹤接聽程式的 屬性， Name 追蹤接聽程式的 屬性預設為空字串 （“” ）。 如果您的應用程式只有一個接聽程式，您可以新增它而不指定名稱，而且您可以藉由指定名稱的空字串來移除它。 不過，如果您的應用程式有多個接聽程式，您應該為每個追蹤接聽程式指定唯一的名稱，這可讓您識別及管理集合中的 TraceSource.Listeners 個別追蹤接聽程式。

注意

新增相同類型的多個追蹤接聽程式，且具有相同名稱，只會產生該型別的一個追蹤接聽程式，以及要新增至集合的名稱 Listeners 。 不過，您可以透過程序設計方式將多個相同的接聽程式新增至 Listeners 集合。

屬性的值 initializeData 取決於您建立的接聽程序類型。 並非所有追蹤接聽程式都需要您指定 initializeData。

注意

當您使用 initializeData 屬性時，可能會收到編譯程式警告「未宣告 』initializeData' 屬性」。因為組態設定會根據無法辨識initializeData屬性的抽象基類TraceListener進行驗證，因此會發生這個警告。 一般而言，您可以忽略具有採用參數之建構函式的追蹤接聽程序實作的這個警告。

下表顯示 .NET Framework 隨附的追蹤接聽程式，並描述其 initializeData 屬性的值。

追蹤接聽程序類別 initializeData 屬性值
System.Diagnostics.ConsoleTraceListener 建 useErrorStream 構函式 ConsoleTraceListener 的值。 將 initializeData 屬性設定為 「true以將追蹤和偵錯輸出寫入標準錯誤數據流;將它設定為」false「 以寫入標準輸出數據流。
System.Diagnostics.DelimitedListTraceListener 寫入的檔名 DelimitedListTraceListener 。
System.Diagnostics.EventLogTraceListener 現有事件記錄檔來源的名稱。
System.Diagnostics.EventSchemaTraceListener 寫入的檔名 EventSchemaTraceListener 。
System.Diagnostics.TextWriterTraceListener 寫入的檔名 TextWriterTraceListener 。
System.Diagnostics.XmlWriterTraceListener 寫入的檔名 XmlWriterTraceListener 。

組態檔

這個元素可用於計算機組態檔 （Machine.config） 和應用程式組態檔。

範例

下列範例示範如何使用 <add> 元素，將接聽程式和consoletextListener追蹤來源 TraceSourceApp的集合加入至 Listeners 。 接 textListener 聽程式會將追蹤輸出寫入檔案myListener.log。

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

另請參閱