共用方式為


<source> 要素

指定一個追蹤來源以啟動追蹤訊息。

<組態>
   <system.diagnostics>
     <資料來源>
       <源>

語法

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

屬性和項目

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

Attributes

Attribute Description
name 選擇性屬性。

指定痕跡來源的名稱。
switchName 選擇性屬性。

指定應用程式中追蹤交換實例的名稱。 若元件未識別 <switches> 開關,該值指定該開關的電平。
switchType 選擇性屬性。

指定走線開關的類型。 若存在,該型別必須是有效的類別名稱,且不能是空字串。
extraAttribute 選擇性屬性。

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

子元素

元素 Description
<聽眾> 包含收集、儲存及路由訊息的監聽者。

父項目

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.diagnostics 指定收集、儲存及路由訊息的追蹤監聽器,以及標記交換器設置的層級。
sources 包含可啟動追蹤訊息的追蹤來源。

備註

此元素可用於機器設定檔(Machine.config)及應用程式設定檔。

Example

以下範例展示了如何使用元素 <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>

另請參閱