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

發行項
08/21/2008

更新：2007 年 11 月

從 Listeners 集合移除接聽程式。

<configuration> 項目
   <system.diagnostics> 項目
     <trace> 項目
       <trace> 的 <listeners> 項目
         <trace> 適用之 <listeners> 的 <remove> 項目

<remove name="listenername" />

屬性和項目

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性	描述
name	必要屬性。要從 Listeners 集合移除的接聽程式名稱。

name

必要屬性。

要從 Listeners 集合移除的接聽程式名稱。

子項目

無。

父項目

項目	描述
configuration	每一個組態檔中的根項目是由 Common Language Runtime 和 .NET Framework 應用程式所使用的。
listeners	指定收集、存放及傳送訊息的接聽程式。接聽程式將追蹤輸出導向至適當的目標。
system.diagnostics	指定收集、存放和傳送訊息的追蹤接聽程式，以及設定追蹤參數的層級。
trace	設定 ASP.NET 追蹤服務。

備註

注意事項：
從 Listeners 集合移除 DefaultTraceListener 會改變 Debug.Assert、Trace.Assert、Debug.Fail 和 Trace.Fail 方法的行為。手動呼叫 Assert 或 Fail 方法通常會導致訊息方塊出現；不過，如果 DefaultTraceListener 不在 Listeners 集合中，則不會顯示此訊息方塊。

範例

以下範例顯示的是如何從追蹤 Listeners 集合移除預設追蹤接聽程式。

<configuration>
   <system.diagnostics>
      <trace autoflush="true" indentsize="0">
         <listeners>
            <remove name="Default" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>