<trace> 的 <listeners> 項目

指定收集、存放及傳送訊息的接聽程式。 接聽程式將追蹤輸出導向至適當的目標。

<listeners> 
  <add>...</add>
  <clear/>
  <remove ... />
</listeners>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

無。

子項目

項目	描述
<trace> 適用之 <listeners> 的 <add> 項目	將接聽項加入至 Listeners 集合。
<trace> 的 <listeners> 適用之 <clear> 項目	清除用於追蹤的 Listeners 集合。
<trace> 適用之 <listeners> 的 <remove> 項目	從 Listeners 集合移除接聽程式。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics	指定 ASP.NET 組態區段的根項目。
trace	包含收集、存放和傳送追蹤訊息的接聽程式。

備註

Debug 和 Trace 類別共用一個 Listeners 集合。 如果您將接聽程式物件加入至其中一個類別的集合，另一個類別會使用相同的接聽程式。 .NET Framework 隨附的接聽程式類別是衍生自 TraceListener 類別。

組態檔

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

範例

下列範例示範如何使用 <listeners> 項目，將接聽程式 MyListener 和 MyEventListener 加入至 Listeners 集合。 MyListener 會建立一個名為 MyListener.log 的檔案，並將輸出寫入至該檔案中。 MyEventListener 會在事件記錄檔中建立項目。

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="0">
      <listeners>
        <add name="myListener" 
          type="System.Diagnostics.TextWriterTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089" 
          initializeData="c:\myListener.log" />
        <add name="MyEventListener"
          type="System.Diagnostics.EventLogTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089"
          initializeData="MyConfigEventLog"/>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

請參閱

參考

追蹤和偵錯設定結構描述

TraceListener