設定 ASP.NET 程式碼追蹤服務。
Syntax
class TraceSection : ConfigurationSection
方法
下表列出 類別所 TraceSection 公開的方法。
| 名稱 | 描述 |
|---|---|
| GetAllowDefinition | (繼承自 ConfigurationSection.) |
| GetAllowLocation | (繼承自 ConfigurationSection。) |
| RevertToParent | (繼承自 ConfigurationSection。) |
| SetAllowDefinition | (繼承自 ConfigurationSection。) |
| SetAllowLocation | (繼承自 ConfigurationSection。) |
屬性
下表列出 類別所 TraceSection 公開的屬性。
| 名稱 | 描述 |
|---|---|
Enabled |
選擇性的讀取/寫入 boolean 值。 true 如果 ASP.NET 應用程式已啟用追蹤，則為 ;否則為 false 。 預設值為 false。啟用追蹤時，您可以在 URL http://<servername>/<applicationroot>/trace.axd 上檢視 Trace.axd 檢視器的記錄錯誤。 您必須將 Enabled 屬性設定為 true ，才能使用檢視器。 注意： Trace.axd 預設會新增至 <httpHandlers> Applicationhost.config 檔案中的 區段。 |
LocalOnly |
選擇性的讀取/寫入 boolean 值。 true 如果追蹤檢視器 (Trace.axd) 只能在主機 Web 服務器上使用; false 如果追蹤檢視器可從任何電腦取得，則為 。 預設值為 true。 |
Location |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
MostRecent |
選擇性的讀取/寫入 boolean 值。 true 如果追蹤存放區會繼續收集最新的追蹤訊息，並開始在達到中指定的限制 RequestLimit 時捨棄較舊的追蹤訊息; false 如果追蹤存放區在達到中指定的數位 RequestLimit 時停止收集追蹤訊息，則為 。 預設值為 false。 注意：此屬性是 .NET Framework 2.0 的新功能。 |
PageOutput |
選擇性的讀取/寫入 boolean 值。 true 如果追蹤資訊已新增至每個網頁的底部，則為 ; false 如果追蹤輸出只能透過追蹤公用程式存取，則為 。 預設值為 false。 注意： 如需 ASP.NET 追蹤檢視器公用程式的詳細資訊，請參閱 如何：使用追蹤檢視器檢視 ASP.NET 追蹤資訊。 |
Path |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
RequestLimit |
選擇性讀取/寫入 sint32 值，指定從 0 到 10000 的追蹤要求數目，以儲存在伺服器上。 預設值為 10。 如果達到限制，且 MostRecent 屬性為 false ，則追蹤會停止。 注意： 雖然屬性接受 RequestLimit 範圍 0 到2147483647的整數值，但如果您指定大於 10000 的值，ASP.NET 會以無訊息方式將它舍入至 10000。 |
SectionInformation |
(繼承自 ConfigurationSection。) |
TraceMode |
選擇性讀取/寫入 sint32 值，指定追蹤資訊顯示的順序。 可能的值稍後會列在一節中。 |
WriteToDiagnosticsTrace |
選擇性的讀取/寫入 boolean 值。 true 如果 ASP.NET 追蹤訊息轉送至 System.Diagnostics 追蹤基礎結構，以供已註冊以顯示追蹤訊息的接聽程式使用;否則為 false 。 預設值為 false。 注意：此屬性是 .NET Framework 2.0 的新功能。 |
子類別
這個類別不包含子類別。
備註
下表列出 屬性的可能值 TraceMode 。 預設值為 1 (SortByTime) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 1 | SortByTime |
指定追蹤資訊會依處理的順序顯示。 |
| 2 | SortByCategory |
指定依使用者定義類別依字母順序顯示追蹤資訊 ：System.Web.TraceCoNtext.Warn 和 System.Web.TraceCoNtext.Write 方法呼叫頁面或伺服器控制項程式碼。 |
繼承階層架構
TraceSection
規格需求
| 類型 | Description |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 檔案 | WebAdministration.mof |
另請參閱
System.Web.TraceCoNtextConfigurationSection 類別
trace 項目 (ASP.NET 設定結構描述)
如何：啟用 ASP.NET 網頁的追蹤
System.Web.TraceCoNtext 方法