<source> 的 <listeners> 適用之 <clear> 項目

發行項
08/12/2011

清除追蹤來源的 Listeners 集合。

<clear/>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

無。

子項目

無。

父項目

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

備註

<clear> 項目會從追蹤來源的 Listeners 集合中移除所有的接聽項，包括 DefaultTraceListener 在內。您可以在使用 <add> 項目之前先使用 <clear> 項目，以確定此集合中沒有其他使用中的接聽項。

組態檔

這個項目可以用於電腦組態檔 (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>