<追蹤><接聽程式>的 <clear> 元素

  • 發行項

清除追蹤的 Listeners 集合。

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <clear>

Syntax

<clear/>

屬性和項目

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

屬性

無。

子元素

無。

父項目

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。
trace 包含用於收集、儲存及路由傳送追蹤訊息的接聽項。
listeners 包含用於收集、儲存及路由訊息的接聽程式。 接聽程式會將追蹤輸出導向至適當的目標。

備註

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

您可以在 Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()) 屬性上呼叫 Clear 方法，以程式設計方式清除 Listeners 集合。

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

注意

<clear> 元素會從 Listeners 集合中移除 DefaultTraceListener，改變 Debug.Assert、Trace.Assert、Debug.Fail 和 Trace.Fail 的方法的行為。 呼叫 Assert 或 Fail 方法通常會導致顯示訊息方塊。 不過，如果 DefaultTraceListener 不在集合中 Listeners，則不會顯示訊息方塊。

範例

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

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

另請參閱