<source> 項目

指定啟始追蹤訊息的追蹤來源。

<source> 
  <listeners>...</listeners>
</source>

屬性和項目

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

屬性

屬性	說明
name	選擇性屬性。 指定追蹤來源的名稱。
switchName	選擇性屬性。 指定應用程式中追蹤參數執行個體的名稱。 如果此參數未在 <switches> 項目中識別，則此值會指定該參數的層級。
switchType	選擇性屬性。 指定追蹤參數的型別。 如果有的話，則此型別必須是有效的類別名稱，且不能是空字串。
extraAttribute	選擇性屬性。 指定追蹤來源特定之屬性的值，這個屬性是由該追蹤來源的 GetSupportedAttributes 方法所識別。

子項目

項目	說明
<trace> 的 <listeners> 項目	包含收集、儲存和傳送訊息的接聽程式。

父項目

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

備註

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

範例

下列範例將示範如何使用 <source> 項目加入追蹤來源 mySource，以及針對名為 sourceSwitch 的來源參數設定層級。 可寫入追蹤資訊的主控台追蹤接聽項會加入到主控台中。

<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>

請參閱

參考

追蹤和偵錯設定結構描述

概念

Trace Sources

追蹤參數