trace 項目 (ASP.NET 設定結構描述)
更新:2007 年 11 月
設定 ASP.NET 程式碼追蹤服務,以控制如何收集、儲存和顯示追蹤結果
configuration 項目 (一般設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
trace 項目 (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 屬性可以是下列其中一個可能值。
預設值為 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 應用程式以及控制這些應用程式之行為的組態項目。 |
備註
trace 項目設定 ASP.NET 程式碼追蹤服務,以控制如何收集、儲存和顯示追蹤結果
在啟用追蹤時,每個網頁要求都會產生追蹤訊息,這些訊息可以附加至頁面輸出,或是儲存在應用程式追蹤記錄中。您可以使用 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 版中,下列預設 element 項目是設定在 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>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
Machine.config 根層次的 Web.config 應用程式層級的 Web.config 虛擬或實體目錄層級的 Web.config |
需求 |
Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 .NET Framework 1.0、1.1 或 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
請參閱
工作
概念
參考
system.web 項目 (ASP.NET 設定結構描述)