包含任何來源或痕跡元素都能參考的監聽者。 這些監聽器預設不會接收任何追蹤,且執行時無法取得這些監聽器。 被識別為共享聽者的人可以依名稱加入來源或追蹤。
<configuration><system.diagnostics><sharedListeners>
語法
<sharedListeners>
<add>...</add>
</sharedListeners>
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
沒有。
子元素
| 元素 | Description |
|---|---|
| <加> | 為收藏增添一位聆聽者 sharedListeners 。 |
父項目
| 元素 | Description |
|---|---|
Configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.diagnostics |
指定 ASP.NET 配置區段的根元素。 |
備註
將一個聆聽者加入共享聆聽者集合,並不代表它就是活躍聆聽者。 它仍必須加入追蹤來源或透過將該追蹤元素的 Listeners 集合加入追蹤。 .NET Framework 中的監聽器類別即源自該 TraceListener 類別。
此元素可用於機器設定檔(Machine.config)及應用程式設定檔。
Example
以下範例說明如何利用該 <sharedListeners> 元素將監聽者 console 加入 Listeners 集合中,涵蓋 和 TraceSourceTrace 類別。 主控台追蹤監聽器透過呼叫或 TraceSourceTrace將追蹤資訊寫入主控台。
<configuration>
<system.diagnostics>
<sharedListeners>
<add name="console" type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Warning" />
</add>
</sharedListeners>
<sources>
<source name="mySource" switchName="sourceSwitch" >
<listeners>
<add name="console" />
</listeners>
</source>
</sources>
<switches>
<add name="sourceSwitch" value="Verbose"/>
</switches>
<trace>
<listeners>
<add name="console" />
</listeners>
</trace>
</system.diagnostics>
</configuration>