共用方式為

用於 <source> 的 <listeners> 元素

  • 發行項

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

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

Syntax

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

屬性和項目

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

屬性

無。

子元素

元素 描述
<add> 將接聽項新增至 Listeners 集合。
<remove> 從 Listeners 集合移除接聽程式。
<clear> 清除追蹤來源的 Listeners 集合。

父項目

元素 Description
configuration 通用語言執行平台和 .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>

另請參閱