共用方式為

<source> 元素

  • 發行項

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

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

Syntax

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

屬性和項目

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

屬性

屬性 描述
name 選擇性屬性。

指定追蹤來源的名稱。
switchName 選擇性屬性。

指定應用程式追蹤參數執行個體的名稱。 如果未在 <switches> 元素識別參數，則值會指定參數的層級。
switchType 選擇性屬性。

指定追蹤參數的類型。 如果存在，類型必須是有效的類別名稱，而且不能是空字串。
extraAttribute 選擇性屬性。

指定由該追蹤來源 GetSupportedAttributes 方法識別的追蹤來源特定屬性值。

子元素

元素 描述
<listeners> 包含用於收集、儲存及路由訊息的接聽程式。

父項目

元素 Description
configuration 通用語言執行平台和 .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>

另請參閱