共用方式為

<來源><接聽程式>的 <remove> 元素

  • 發行項

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

<configuration>
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <remove>

Syntax

<remove name="listenerName" />

屬性和項目

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

屬性

屬性 描述
name 必要屬性。

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

子元素

無。

父項目

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。
sources 包含起始追蹤訊息的追蹤來源。
source 指定起始追蹤訊息的追蹤來源。
listeners 指定收集、儲存和路由訊息的接聽程式。

備註

<remove> 元素會從追蹤來源的 Listeners 集合中移除指定的接聽程式。

您可以在 TraceSource 執行個體的 Listeners 屬性上呼叫 Remove 方法，以程式設計方式從追蹤來源的 Listeners 集合中移除元素。

這個元素可用於機器組態檔 (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>

另請參閱