<trace> 元素
包含用於收集、儲存及路由傳送追蹤訊息的接聽項。
<configuration>
<system.diagnostics>
<trace>
Syntax
<trace autoflush="true|false"
indentsize="indent value"
useGlobalLock="true| false"/>
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
| 屬性 | 描述 |
|---|---|
autoflush |
選擇性屬性。 指定追蹤接聽程式是否在每個寫入作業之後自動排清輸出緩衝區。 |
indentsize |
選擇性屬性。 指定要縮排的空格數目。 |
useGlobalLock |
選擇性屬性。 指出是否應使用全域鎖定。 |
autoflush 屬性
| 值 | 描述 |
|---|---|
false |
不會自動排清輸出緩衝區。 此為預設值。 |
true |
自動排清輸出緩衝區。 |
useGlobalLock Attribute
| 值 | 描述 |
|---|---|
false |
如果接聽程式是為安全執行緒，請勿使用全域鎖定；否則，請使用全域鎖定。 |
true |
無論接聽程式是否為安全執行緒，都會使用全域鎖定。 此為預設值。 |
子元素
| 元素 | 描述 |
|---|---|
| <listeners> | 指定收集、儲存及路由訊息的接聽程式。 |
父項目
| 元素 | Description |
|---|---|
configuration |
通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.diagnostics |
指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。 |
範例
下列範例示範如何使用 <trace> 元素將接聽程式 MyListener 加入 Listeners 集合。 MyListener 會建立名為 MyListener.log 的檔案，並將輸出寫入檔案。 useGlobalLock 屬性設定為 false，如果追蹤接聽程式是安全執行緒，則不會使用全域鎖定。 autoflush 屬性設定為 true，這會導致追蹤接聽程式寫入檔案，而不論是否呼叫方法 Trace.Flush。 indentsize 屬性設定為 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>
