<source><listeners> 的 <clear> 元素

  • 發行項

清除追蹤來源的 Listeners 集合。

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

Syntax

<clear/>

屬性和項目

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

屬性

無。

子元素

無。

父項目

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

備註

<clear> 元素會從追蹤來源的 Listeners 集合中移除所有接聽程式，包括 DefaultTraceListener。 您可以先使用 <clear> 元素，然後再使用 <add> 元素，確定集合中沒有其他作用中的接聽程式。

組態檔

這個元素可用於機器組態檔 (Machine.config) 及應用程式組態檔。

範例

下列範例說明如何先使用 <clear> 元素，然後再使用 <add> 元素，以將接聽程式 console 和 textListener 新增至追蹤來源 TraceSourceApp 的 Listeners 集合。

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </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>

另請參閱