<trace> 項目
包含收集、存放和傳送追蹤訊息的接聽程式。
<trace autoflush="true|false"
indentsize="indent value"
useGlobalLock="true| false"/>
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
屬性 |
說明 |
|---|---|
autoflush |
選擇性屬性。 指定每次寫入作業後，追蹤接聽程式是否會自動清除輸出緩衝區。 |
indentsize |
選擇性屬性。 指定要縮排的空格數。 |
useGlobalLock |
選擇性屬性。 指示是否應使用全域鎖定。 |
Autoflush 屬性
值 |
說明 |
|---|---|
false |
不自動清除輸出緩衝區。 這是預設值。 |
true |
自動清除輸出緩衝區。 |
useGlobalLock 屬性
值 |
說明 |
|---|---|
false |
如果接聽器是安全執行緒 (Thread Safe)，請勿使用全域鎖定，否則請使用全域鎖定。 |
true |
不論接聽器是否為安全執行緒，一律使用全域鎖定。 這是預設值。 |
子項目
項目 |
說明 |
|---|---|
指定收集、存放及傳送訊息的接聽程式。 |
父項目
項目 |
說明 |
|---|---|
configuration |
Common Language Runtime 和 .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>