<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>

另請參閱