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

發行項
08/21/2008

更新：2007 年 11 月

從追蹤來源的 Listeners 集合中移除接聽項。

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

 <remove name="listenerName" />

屬性和項目

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

屬性

屬性	說明
name	必要的屬性。要從 Listeners 集合中移除的接聽項名稱。

子項目

無

父項目

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

備註

<remove> 項目會從追蹤來源的 Listeners 集合中移除指定的接聽項。

您可以程式方式從追蹤來源的 Listeners 集合中移除項目，透過的方式是呼叫 TraceSource 執行個體之 Listeners 屬性上的 Remove 方法。

這個項目可以用於電腦組態檔 (Machine.config) 和應用程式組態檔。

範例

下列範例將示範如何先使用 <remove> 項目之後，再使用 <add> 項目將接聽項 console 加入到追蹤來源 TraceSourceApp 的 Listeners 集合中。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>