包含收集、儲存及路由追蹤訊息的聽眾。
<Configuration><System.Diagnostics><Trace>
語法
<trace autoflush="true|false"
indentsize="indent value"
useGlobalLock="true| false"/>
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
autoflush |
選擇性屬性。 指定追蹤監聽器是否會在每次寫入操作後自動清除輸出緩衝區。 |
indentsize |
選擇性屬性。 指定縮排的空格數。 |
useGlobalLock |
選擇性屬性。 指示是否應使用全域鎖。 |
自動沖洗屬性
| 價值觀 | Description |
|---|---|
false |
不會自動沖洗輸出緩衝區。 這是預設值。 |
true |
會自動沖洗輸出緩衝區。 |
useGlobalLock 屬性
| 價值觀 | Description |
|---|---|
false |
若監聽者是執行緒安全的，則不使用全域鎖;否則，則使用全域鎖。 |
true |
不論監聽器是否執行緒安全，都會使用全域鎖。 這是預設值。 |
子元素
| 元素 | Description |
|---|---|
| <聽眾> | 指定一個負責收集、儲存及路由訊息的監聽者。 |
父項目
| 元素 | Description |
|---|---|
configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.diagnostics |
指定收集、儲存及路由訊息的追蹤監聽器，以及標記交換器設置的層級。 |
Example
以下範例說明如何利用該 <trace> 元素將監聽器 MyListener 加入 Listeners 集合。
MyListener 建立一個命名 MyListener.log 的檔案，並將輸出寫入該檔案。
useGlobalLock屬性設為 false，若追蹤監聽器為執行緒安全，則全域鎖不會被使用。
autoflush屬性設為 true，這會使追蹤監聽器無論是否Trace.Flush呼叫該方法都會寫入該檔案。
indentsize屬性設為 0（0），當呼叫該方法時，監聽者會縮排零空格Trace.Indent。
<configuration>
<system.diagnostics>
<trace useGlobalLock="false" 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" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
