trace 項目 (ASP.NET 設定結構描述)

發行項
08/12/2011

設定 ASP.NET 程式碼追蹤服務，以控制如何收集、儲存和顯示追蹤結果

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性	描述
enabled	選擇性 Boolean 屬性。指定是否啟用應用程式的追蹤功能。必須啟用追蹤才能使用 Trace.axd 檢視器。根據預設，Trace.axd 檢視器會加入至 httpHandlers 項目。預設值為 false。
localOnly	選擇性 Boolean 屬性。指定追蹤檢視器 (Trace.axd) 是否只能在主機 Web 伺服器上使用。如果為 false，追蹤檢視器即可在任何電腦上使用。根據預設，Trace.axd 檢視器會加入至 httpHandlers 項目。預設值為 true。
mostRecent	選擇性 Boolean 屬性。指示是否顯示最新的應用程式層級追蹤輸出，並捨棄已超出 requestLimit 指定限制的舊追蹤資料。如果為 false，就會顯示要求的追蹤資料，直到達到 requestLimit 屬性 (Attribute) 為止。這個屬性是 .NET Framework 2.0 版中新增的屬性。預設值為 false。
pageOutput	選擇性 Boolean 屬性。指定在每個網頁結尾是否轉譯追蹤輸出。如果為 false，就只能透過追蹤公用程式存取追蹤輸出。預設值為 false。
requestLimit	選擇性 Int32 屬性。指定儲存在伺服器的追蹤要求個數。如果達到這項限制，而且 mostRecent 屬性為 false，就會自動停用追蹤。要求上限為 10,000。如果指定大於 10,000 的值，ASP.NET 便會自動將它縮減為 10,000。預設值為 10。
traceMode	選擇性 TraceDisplayMode 屬性。指定顯示追蹤資訊的順序。 traceMode 屬性可以是下列其中一個可能值。值描述 SortByCategory 指定依使用者定義分類的英文字母順序來顯示追蹤資訊。 SortByTime 指定依處理追蹤資訊的順序來顯示追蹤資訊。預設值為 SortByTime。
writeToDiagnosticsTrace	選擇性 Boolean 屬性。針對已註冊要顯示 Trace 訊息的任何接聽項，指定是否要將 ASP.NET 追蹤訊息 (Trace Message) 轉送至 System.Diagnostics 追蹤基礎結構。如需詳細資訊，請參閱 system.diagnostics 的 trace 項目。這個屬性是 .NET Framework 2.0 版中新增的屬性。預設值是 false。

子項目

無。

父項目

項目	描述
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每一個組態檔中的必要根項目 (Root Element)。
system.web	指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。

備註

追蹤功能啟動後，每一個網頁要求動作都會產生追蹤訊息，並附加到該網頁的輸出結果，或存放在應用程式的追蹤記錄檔。用 ASP.NET 追蹤檢視器 (Trace.axd) 就可以檢視追蹤記錄檔的內容。根據預設，Trace.axd 會加入至 httpHandlers 項目。

注意事項
一般而言，您不應該在現用的網站啟用追蹤，因為這樣可能會將敏感的組態資訊顯示給每個檢視網頁的人。追蹤的使用應該僅限於偵錯用途。如果 localOnly 屬性為 true，就只會顯示 localhost 要求的追蹤資訊。此外，如果在 Web.config 檔案中設定 <deployment retail=true>，就會停用追蹤。

您可以使用 Trace 類別中的屬性和方法檢測發行的組建 (Release Build)。檢測能夠讓您以實際設定執行應用程式的方式，監視應用程式的狀況。追蹤則協助您隔離問題，並修正這些問題而不干擾執行中的系統。

為了讓追蹤生效，您必須設定追蹤旗標，並重新編譯應用程式。您可以在要支援追蹤之語言編譯器的組態列中，將 compilerOptions 屬性設定為 ="/d:TRACE"，以設定追蹤旗標。請參考 <compiler> 項目

預設的組態

下列預設 trace 項目不會明確地設定在 Machine.config 檔案或根 Web.config 檔案中。不過，這是 .NET Framework 2.0 (含) 以後版本中應用程式所傳回的預設組態。

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

在 .NET Framework 1.0 和 1.1 版中，下列預設 trace 項目是設定在 Machine.config 檔案中。

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

範例

下列程式碼範例示範如何指定追蹤組態設定。

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

項目資訊

組態區段處理常式	TraceSection
組態成員	TraceSection
可設定的位置	Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config
需求	Microsoft Internet Information Services (IIS) 5.0 或更新版本 .NET Framework Microsoft Visual Studio

請參閱

trace 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設的組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源