@Page指令的用法

ASP.NET頁面@Page指令屬性有：

AspCompat、Async、AsyncTimeout、AutoEventWireup、Buffer、ClassName、ClientIDMode、

CodeBehind、CodeFile、CodeFileBaseClass、CodePage、CompilationMode、ContentType、

CompilerOptions、Culture、Debug、EnableEventValidation、EnableSessionState、EnableTheming 、EnableViewState、 EnableViewStateMac 、ErrorPage 、Explicit、 Inherits、 Language、 LCID 、LinePragmas、MaintainScrollPositionOnPostback、 MasterPageFile、 MetaDescription 、MetaKeywords 、ResponseEncoding、Src、Strict、StylesheetTheme、Theme、Title、Trace 、TraceMode 、Transaction 、UICulture、ValidateRequest、ViewStateEncryptionMode、

ViewStateMode、WarningLevel。

AspCompat通過設定頁面在單線程單元中運作，使得ASP.NET頁面能夠通路傳統的COM對象。ASP.NET頁面預設是在多線程單元(MTA)中運作。當啟用AspCompant模式時，設定ASP.NET在單線程單元（STA）中運作頁面，以便它能夠安全地與COM對象互動。AspCompat設定為true會影響性能。預設為false。

Async使頁面成為異步處理程式，即導緻頁使用IHttpAsyncHandler的實作來處理請求，預設為false。

AsyncTimeout定義在處理異步任務時使用的逾時的時間間隔（以秒為機關）。預設為45秒。

AutoEventWireup訓示頁面的事件是否自動綁定。如果啟用了事件的自動綁定，則為true；否則為false。預設值為true。

Buffer确定是否啟用HTTP響應緩沖。如果啟用頁面緩沖為true；否則為false。預設為true。

ClassName指定在請求該頁面時将自動進行動态編譯的頁的類名。此值可以是任何有效的類名，并且可以包括類的完整命名空間。如果未指定該屬性的值，則已編譯的類名将基于頁的檔案名。其他頁可以通過使用 @ Reference 指令來引用配置設定給第一頁的類名。

ClientTarget訓示 ASP.NET 伺服器控件應該為其呈現内容的目标使用者代理（通常是 Web 浏覽器，例如 Microsoft Internet Explorer）。該值可以是應用程式配置檔案的節中定義的任何有效别名。

CodeBehind指定包含與頁關聯的類的已編譯檔案的名稱。該屬性不能在運作時使用。提供此屬性是為了與以前版本的ASP.NET 的相容，以實作代碼隐藏功能。在 ASP.NET 2.0 版中，應改用 CodeFile 屬性指定該源檔案的名稱，同時使用 Inherits 屬性指定該類的完全限定名稱。

CodeFile指定指向頁引用的代碼隐藏檔案的路徑。此屬性與 Inherits 屬性一起使用可以将代碼隐藏源檔案與網頁相關聯。此屬性僅對編譯的頁有效。

CodeFileBaseClass指定頁的基類及其關聯的代碼隐藏類的路徑。此屬性是可選的，但如果使用此屬性，則必須同時使用 CodeFile 屬性。如果希望實作以下共享方案，可使用該屬性：在該共享方案中，您在基類中定義通用字段（可以選擇性地定義關聯事件）以引用在網頁中聲明的控件。出于 ASP.NET 代碼生成模型的緣故，如果您在基類中定義字段時沒有使用該屬性，則編譯時将為在網頁中（在單獨的分部類存根中）聲明的控件生成新的成員定義，而您希望的方案将無法生效。但是，如果您使用 CodeFileBaseClass 屬性将基類與頁相關聯，并且您的分部類（其名稱配置設定給 Inherits屬性，并且其源檔案由 CodeFile 屬性引用）是從該基類繼承的，則該基類中的字段在代碼生成之後将能夠引用頁上的控件。

CodePage訓示用于響應的編碼方案的值。該值是一個用作編碼方案 ID 的整數。有關可能的 CodePage ID 的清單，請參見 Encoding 類。

CompilationMode設定是否應使用指定多個枚舉選項之一的字元串來編譯頁。預設值為 Always，是以，預設情況下編譯 .aspx 頁。包含用于編譯頁的編譯器選項的字元串。在 C# 和 Visual Basic 中，這是編譯器指令行開關的序列。有關編譯器選項的更多資訊，請參見 C# 編譯器選項或 Visual Basic 編譯器。

ContentType将響應的 HTTP 内容類型定義為标準的 MIME 類型。

CompilerOptions支援任何有效的 HTTP 内容類型字元串。有關可能值的清單，請在 MSDN Library 中搜尋 MIME。Culture訓示頁的區域性設定。該屬性的值必須是有效的區域性 ID。注意，LCID 和 Culture 屬性是互相排斥的；如果使用了其中一個屬性，就不能在同一頁中使用另一個屬性。

Culture動态生成的類将設定此屬性的值。此外，還可以通過程式設計方式或在 Web.config 檔案的 globalization 元素（ASP.NET 設定架構）中顯式設定 Culture 屬性的值。Culture 屬性用于幫助本地化頁内容。可以将其設定為任何有效的區域性 ID。例如，en-us 區域性 ID 将頁設定為美國英語，而 fr 區域性 ID 将頁設定為法語。還可以将該值設定為 auto，進而自動檢測浏覽器的首選語言并設定該語言。可以用預設值（如 auto:en-us）限定自動語言檢測。

Debug訓示是否應使用調試符号編譯該頁。如果應使用調試符号編譯該頁，則為 true；否則為 false。由于此設定影響性能，是以隻應在開發期間将此屬性設定為 true。

EnableEventValidation在回發方案中啟用事件驗證。如果驗證事件，則為 true；否則為 false。預設值為 true。

EnableSessionState定義頁的會話狀态要求。如果啟用了會話狀态，則為 true；如果可以讀取會話狀态但不能進行更改，則為 ReadOnly；否則為 false。預設值為 true。這些值是不區分大小寫的。

EnableTheming訓示是否在頁上使用主題。如果使用主題，則為 true；否則為 false。預設值為 true。

EnableViewState訓示是否在頁請求之間保持視圖狀态。如果要保持視圖狀态，則為 true；否則為 false。預設值為 true。

EnableViewStateMac訓示當頁從用戶端回發時，ASP.NET 是否應該對頁的視圖狀态運作計算機身份驗證檢查(MAC)。如果應該對視圖狀态運作 MAC 檢查，則為 true；否則為 false。預設值為 false。視圖狀态 MAC 是隐藏變量的加密版本，當某頁被發送到浏覽器時，該頁的視圖狀态永久保持到該變量中。當您将此屬性設定為 true 時，将檢查加密的視圖狀态以驗證它在用戶端未被篡改。注意，将此屬性設定為 true 會影響性能，因為在頁的每次往返行程中，都必須加密和解密變量值。

ErrorPage定義在出現未處理頁異常時用于重定向的目标 URL。

Explicit确定是否使用 Visual Basic Option Explicit 模式來編譯頁。如果啟用了 VisualBasic 顯式編譯選項，且所有變量必須使用 Dim、Private、Public 或 ReDim 語句來聲明，則為 true；否則為 false。預設值為 false。除了 Visual Basic，所有其他語言都忽略該屬性。此外，該選項在 Machine.config 配置檔案中被設定為 true。

Inherits定義供頁繼承的代碼隐藏類。它可以是從Page 類派生的任何類。它與 CodeFile 屬性（包含指向代碼隐藏類的源檔案的路徑）一起使用。

本文轉自HDDevTeam 51CTO部落格，原文連結：http://blog.51cto.com/hddev/1253853，如需轉載請自行聯系原作者