用於 <source> 的 <listeners> 元素
針對 TraceSource 加入或移除 Listeners 集合中的接聽程式。 接聽項會將追蹤輸出導向至適當的目標,例如記錄檔、視窗或文字檔。
<configuration>
<system.diagnostics>
<sources>
<source>
<listeners>
Syntax
<listeners>
<add>...</add>
<remove ... />
<clear/>
</listeners>
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
無。
子元素
元素 | 描述 |
---|---|
<add> | 將接聽項新增至 Listeners 集合。 |
<remove> | 從 Listeners 集合移除接聽程式。 |
<clear> | 清除追蹤來源的 Listeners 集合。 |
父項目
元素 | Description |
---|---|
configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.diagnostics |
指定用於收集、儲存及路由傳送訊息的追蹤接聽項,以及設定追蹤參數的層級。 |
sources |
包含起始追蹤訊息的追蹤來源。 |
source |
指定起始追蹤訊息的追蹤來源。 |
備註
組態檔
這個元素可用於機器組態檔 (Machine.config) 及應用程式組態檔。
範例
下列範例示範如何使用 <listeners>
元素將主控台追蹤接聽程式新增至 mySource
來源,以及移除預設追蹤接聽程式。
<configuration>
<system.diagnostics>
<sources>
<source name="mySource" switchName="sourceSwitch"
switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener">
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error"/>
</add>
<remove name="Default"/>
</listeners>
</source>
</sources>
<switches>
<add name="sourceSwitch" value="Warning"/>
</switches>
</system.diagnostics>
</configuration>