指定一個追蹤來源以啟動追蹤訊息。
<組態>
<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>