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

發行項
08/12/2011

清除用於追蹤的 Listeners 集合。

<clear/>

屬性和項目

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

屬性

無。

子項目

無。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics	指定收集、存放和傳送訊息的追蹤接聽程式，以及設定追蹤切換控制的層級。
trace	包含收集、存放和傳送追蹤訊息的接聽程式。
listeners	包含收集、儲存和傳送訊息的接聽程式。接聽程式將追蹤輸出導向至適當的目標。

備註

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

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

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