表示 <pages> Web.config檔案的 區段。
Syntax
class PagesSection : ConfigurationSectionWithCollection
方法
下表列出 類別所 PagesSection 公開的方法。
| 名稱 | 描述 |
|---|---|
| 加入 | (繼承自 ConfigurationSectionWithCollection.) |
| 清除 | (繼承自 ConfigurationSectionWithCollection。) |
| Get | (繼承自 ConfigurationSectionWithCollection。) |
| GetAllowDefinition | (繼承自 ConfigurationSection.) |
| GetAllowLocation | (繼承自 ConfigurationSection。) |
| 移除 | (繼承自 ConfigurationSectionWithCollection。) |
| RevertToParent | (繼承自 ConfigurationSection。) |
| SetAllowDefinition | (繼承自 ConfigurationSection。) |
| SetAllowLocation | (繼承自 ConfigurationSection。) |
屬性
下表列出 類別所 PagesSection 公開的屬性。
| 名稱 | 描述 |
|---|---|
AsyncTimeout |
讀取/寫入 datetime 值，指定頁面將等候執行非同步工作的時間。 預設值為 45 秒。 |
AutoEventWireup |
讀取/寫入 boolean 值。 如果 ASP.NET 頁面的事件自動連接到事件處理函式，則為 true，否則為 false。 預設為 true。 注意： 當此屬性為 true 時，ASP.NET 不需要事件來指定 事件處理常式，例如 Page_Load 或 Page_Init 。 這表示 Handles 在 Web Form 頁面中的伺服器腳本中不需要 Visual Basic 中的 關鍵字。 根據預設，在 Visual Studio 中建立 ASP.NET Web 應用程式時，屬性的值 AutoEventWireup 會在 .aspx 頁面或 .ascx 控制項中設定 false 為 ，而且不會自動建立事件處理常式。 如果效能是關鍵考慮，請勿設定 AutoEventWireuptrue 為 。 |
Buffer |
讀取/寫入 boolean 值。 如果 .aspx 頁面和 .ascx 控制項使用回應緩衝，則為 true，否則為 false。 預設為 true。 注意： 開啟回應緩衝時，頁面或控制項輸出會經過緩衝處理，直到處理整個頁面或控制項之後。 如果效能是關鍵考慮，請勿將此屬性 true 設定為 。 |
CompilationMode |
讀取/寫入 sint32 列舉，指定執行時間是否編譯 .aspx 頁面和 .ascx 控制項。 可能的值稍後會列在一節中。 |
Controls |
TagPrefixInfo值，其中包含自訂和使用者控制項的組態資訊。 |
EnableEventValidation |
boolean 值。 true 如果應該執行事件驗證，則為 ;否則為 false 。 預設值為 true。事件驗證機制可消除控制項中未經授權回傳要求和回呼的風險。 在轉譯期間，控制項會註冊其事件，然後只會驗證在回傳要求或回呼期間可在控制項上引發的特定事件。 ASP.NET 中的所有事件驅動控制項現在預設都會使用此功能。 不過，您可以選擇停用 Web 應用程式的事件驗證，以還原為 .NET Framework 1.0 版行為。 注意： 基底控制項會檢查這個屬性，以判斷它是否應該驗證事件。 衍生控制項不會繼承此基底控制項設定，因此預設會豁免事件驗證。 您仍然可以指示 ASP.NET 將 屬性新增 EnableEventValidation 至衍生控制項本身，並將其設定為 true ，以對衍生控制項執行事件驗證。 |
EnableSessionState |
讀取/寫入 sint32 值，指定是否啟用會話狀態。 可能的值稍後會列在一節中。 |
EnableViewState |
讀取/寫入 boolean 值。 true 如果已啟用檢視狀態，則為 ;否則， false. 預設值為 true 。 |
EnableViewStateMac |
讀取/寫入 boolean 值。 true 如果 ASP.NET 應該在頁面的檢視狀態上執行訊息驗證檢查，當頁面從用戶端傳回時;否則為 false 。 預設值為 true。 注意： 基於安全性考慮，此屬性應一律設定為 true。 |
Location |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
MaintainScrollPositionOnPostBack |
讀取/寫入 boolean 值。 true 如果應該在回傳之後維護瀏覽器頁面捲動位置，則為 ;否則為 false 。 預設值為 false。 |
MasterPageFile |
讀取/寫入 string 值，指定應用程式的主版頁面參考。 字串可以包含相對路徑或絕對路徑。 |
MaxPageStateFieldLength |
讀取/寫入 sint32 值，指定單一檢視狀態欄位可以包含的最大字元數。 預設值為 –1 (未指定任何限制) 。如果預存資料的長度超過指定的值，資料就會在多個檢視狀態欄位之間分割。 |
Namespaces |
NamespaceInfo值，其中包含自動匯入 Web 應用程式所有頁面的命名空間參考。 這可讓指定命名空間的類別可供在頁面上使用。 |
PageBaseType |
讀取/寫入 string 值，指定 .aspx 頁面預設繼承的程式碼後置類別。 預設值為 「System.Web.UI.Page」。 |
PageParserFilterType |
指定剖析器篩選類型的讀取/寫入 string 值。 剖析器篩選是 System.Web.UI.PageParserFilter 類別的 實例。 在執行時間，頁面編譯器會呼叫剖析器篩選準則，以在剖析頁面之前檢查原始程式碼的變更。 |
Path |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
SectionInformation |
(繼承自 ConfigurationSection。) |
SmartNavigation |
讀取/寫入 boolean 值。 如果已啟用智慧型巡覽則為 true；否則為 false。 預設值為 false。 注意： 智慧型導覽需要 Microsoft Internet Explorer 5.5、6 或 7。 |
StyleSheetTheme |
可讀寫 string 的值，指定 ASP.NET 樣式表單主題的名稱。 |
TagMapping |
TagMapInfo值，其中包含組態標記重新對應語句。 此屬性可讓您在編譯時期重新對應標籤的類型。 重新對應會導致對應類型用來取代組態檔範圍內所有頁面和 ASP.NET 控制項的原始標籤類型。 |
Theme |
讀取/寫入 string 值，指定頁面主題 ASP.NET 的名稱。 |
UserControlBaseType |
讀取/寫入 string 值，指定使用者預設會繼承的程式碼後置類別。 預設值為 「System.Web.UI.UserControl」。 |
ValidateRequest |
讀取/寫入 boolean 值。 true 如果 ASP.NET 在瀏覽器的所有輸入上執行要求驗證;否則為 false 。 預設值為 true。要求驗證是藉由比較輸入資料與潛在危險值的清單來執行。 如果發生相符專案，ASP.NET 會引發 System.Web.HttpRequestValidationException。 |
ViewStateEncryptionMode |
讀取/寫入 sint32 列舉，指定 ASP.NET 用於檢視狀態值的加密模式。 後續的一節會列出可能的值。 |
子類別
這個類別不包含子類別。
備註
下表列出 屬性的 CompilationMode 可能值。 預設值為 2 (Always) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | Auto |
如果可能的話，ASP.NET 不會編譯頁面。 |
| 1 | Never |
頁面或控制項永遠不會動態編譯。 此設定會從編譯器取消指定的頁面，藉以提升效能。 如果頁面包含需要編譯的腳本區塊或程式碼建構，ASP.NET 會傳回錯誤，而且頁面不會執行。 |
| 2 | Always |
此頁面應該始終都要編譯。 |
下表列出 屬性的 EnableSessionState 可能值。 預設值為 2 (True) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | False |
會話狀態已停用。 |
| 1 | ReadOnly |
會話狀態為唯讀。 |
| 2 | True |
會話狀態已啟用。 |
下表列出 屬性的 ViewStateEncryptionMode 可能值。 預設值為 0 (Auto) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | Auto |
如果控制項藉由呼叫 System.Web.UI.Page.RegisterRequiresViewStateEncryption 方法來要求加密，則會加密檢視狀態資訊。 |
| 1 | Always |
檢視狀態資訊永遠加密。 |
| 2 | Never |
檢視狀態資訊永遠不加密，即使控制項要求加密。 |
繼承階層架構
ConfigurationSectionWithCollection
PagesSection
規格需求
| 類型 | 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 |
另請參閱
Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSectionSystem.Web.HttpRequestValidationException
AspSession 類別
ConfigurationSectionWithCollection 類別
NamespaceInfo 類別
SessionPageStateSection 類別
SessionStateSection 類別
TagMapElement 類別
TagMapInfo 類別
TagPrefixElement 類別
TagPrefixInfo 類別
CompilationMode 列舉