<system.diagnostics> 元素

  • 發行項

指定用於收集、儲存及路由傳送訊息的追蹤接聽項，以及設定追蹤參數的層級。

<configuration>
  <system.diagnostics>

Syntax

<system.diagnostics>
</system.diagnostics>

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

無。

子元素

元素 描述
<assert> 指定呼叫 Debug.Assert 方法時是否要顯示訊息方塊，此外也會指定寫入訊息之目的地檔案的名稱。
<performanceCounters> 指定效能計數器共用之全域記憶體的大小。
<sharedListeners> 包含任何來源或追蹤項目可參考的接聽項。 識別為共用接聽程式的接聽程式可依名稱加入來源或追蹤。
<sources> 指定起始追蹤訊息的追蹤來源。
<switches> 包含追蹤參數及設定追蹤參數的層級。
<trace> 包含用於收集、儲存及路由傳送追蹤訊息的接聽項。

父項目

元素 Description
configuration 通用語言執行平台和 .NET Framework 應用程式所使用之每個組態檔中的根項目。

範例

下列範例示範如何在 <system.diagnostics> 元素內嵌追蹤參數及追蹤接聽程式。 General 追蹤參數會設定為 TraceLevel 層級。 追蹤接聽程式 myListener 會建立名為 MyListener.log 的檔案，並將輸出寫入檔案。

注意

在 .NET Framework 2.0 版中，您可以使用文字來指定參數的值。 例如，您可針對 BooleanSwitch 指定 true，或使用代表列舉值的文字，例如 Error 為 TraceSwitch。 <add name="myTraceSwitch" value="Error" /> 這一行相當於 <add name="myTraceSwitch" value="1" />。

<configuration>  
   <system.diagnostics>  
      <switches>  
         <add name="General" value="4" />  
      </switches>  
      <trace autoflush="true" indentsize="2">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

另請參閱