<source> 的 <listeners> 項目

更新：2007 年 11 月

在 TraceSource 的 Listeners 集合中加入或移除接聽項。接聽項會將追蹤輸出導向至適當的目標，例如，記錄檔、視窗或文字檔。

<configuration> 項目
  <system.diagnostics> 項目
    <sources> 項目
      <source> 項目
        <source> 的 <listeners> 項目

<listeners> 
  <add>...</add>
  <remove ... />
  <clear/>
</listeners>

屬性和項目

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

屬性

無

子項目

項目	描述
<source> 的 <listeners> 適用之 <add> 項目	將接聽程式加入至 Listeners 集合。
<source> 的 <listeners> 適用之 <remove> 項目	從 Listeners 集合移除接聽程式。
<source> 的 <listeners> 適用之 <clear> 項目	清除追蹤來源的 Listeners 集合。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics	指定收集、存放和傳送訊息的追蹤接聽程式，以及設定追蹤切換控制的層級。
sources	包含啟始追蹤訊息的追蹤來源。
source	指定啟始追蹤訊息的追蹤來源。

備註

組態檔

這個項目可以用於電腦組態檔 (Machine.config) 和應用程式組態檔。

範例

下列範例將示範如何使用 <listeners> 項目，將主控台追蹤接聽項加入到 mySource 來源，以及移除預設的追蹤接聽項。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

請參閱

概念

追蹤接聽項

參考

追蹤和偵錯設定結構描述

TraceListener