asp.net中的@page指令

@Page指令 

@Page指令允許開發人員爲頁面指定多個配置選項,並且該指令只能在Web窗體頁中使用。每個.aspx文件只能包含一條@Page指令。@Page指令可以指定:頁面中代碼的服務器編程語言;頁面是將服務器代碼直接包含在其中(即單文件頁面),還是將代碼包含在單獨的類文件中(即代碼隱藏頁面);調試和跟蹤選項,以及頁面是否爲某母版頁的內容頁。

語法:

<%@ Page attribute="value" [attribute="value"...]%>


attribute 爲@Page指令的屬性。@Page指令語法中各屬性的說明如表所示。

表  @Page指令屬性說明

屬性
描述

Async
使頁成爲異步處理程序默認值爲false

AsyncTimeOut
定義在處理異步任務時使用的超時時間間隔(以秒爲單位)。默認值爲45秒。該值必須是整數

AutoEventWireup
指示頁的事件是否自動綁定。如果啓用了事件自動綁定,則爲true;否則爲false。默認值爲true

Buffer
確定是否啓用了HTTP響應緩衝。如果啓用了頁緩衝,則爲true;否則爲false。默認值爲true

ClassName
一個字符串,指定在請求頁時將自動進行動態編譯的頁的類名。此值可以是任何有效的類名,並且可以包括類的完整命名空間(完全限定的類名)。如果未指定該屬性的值,則已編譯頁的類名將基於頁的文件名

CodeFile
指定指向頁引用的代碼隱藏文件的路徑

CodeFileBaseClass
指定頁的基類及其關聯的代碼隱藏類的路徑。此屬性是可選的,但如果使用此屬性,則必須同時使用CodeFile屬性

CodePage
指示用於響應的編碼方案的值

CompilationMode
設置是否應使用指定多個枚舉選項之一的字符串來編譯頁。默認值爲 Always,因此,默認情況下編譯 .aspx 頁

Culture
指示頁的區域性設置。該屬性的值必須是有效的區域性ID。注意,LCID和Culture屬性是互相排斥的;如果使用了其中一個屬性,就不能在同一頁中使用另一個屬性

Debug
指示是否應使用調試符號編譯該頁。如果應使用調試符號編譯該頁,則爲 true;否則爲 false。由於此設置影響性能,因此只應在開發期間將此屬性設置爲 true

Description
提供該頁的文本說明。ASP.NET分析器忽略該值

EnableEventValidation
在回發方案中啓用事件驗證。如果驗證事件,則爲true;否則爲false。默認值爲true

EnableSessionState
定義頁的會話狀態要求。如果啓用了會話狀態,則爲true;如果可以讀取會話狀態但不能進行更改,則爲ReadOnly;否則爲false。默認值爲true。這些值不區分大小寫

EnableTheming
指示是否在頁上使用主題。如果使用主題,則爲true;否則爲false。默認值爲true

EnableViewState
指示是否在頁請求之間保持視圖狀態。如果要保持視圖狀態,則爲true;否則爲false。默認值爲true

ErrorPage
定義在出現未處理頁異常時用於重定向的目標URL

Inherits
定義供頁繼承的代碼隱藏類。它與CodeFile 屬性(包含指向代碼隱藏類的源文件的路徑)一起使用

Language
指定在對頁中的所有內聯呈現(<% %> 和 <%= %>)和代碼聲明塊進行編譯時使用的語言。值可以表示任何.NET Framework支持的語言,如C# 

LCID
定義Web窗體頁的區域設置標識符

MaintainScrollPosition

OnPostback
設置在回發後是否將客戶端的頁面返回到請求前的同一位置,默認爲false

MasterPageFile
設置內容頁的母版頁或嵌套母版頁的路徑。支持相對路徑和絕對路徑

ResponseEncoding
指示用於包含頁內容的HTTP響應的編碼方案的名稱。分配給該屬性的值是有效的編碼名稱

SmartNavigation
指示頁是否支持Internet Explorer 5.5或更高版本的智能導航功能。如果啓用了智能導航,則爲true;否則爲false。默認值爲false

Src
指定包含鏈接到頁的代碼的源文件的路徑。在鏈接的源文件中,可以選擇將頁的編程邏輯包含在類中或代碼聲明塊中。可以使用Src屬性將生成提供程序鏈接到頁

StyleSheetTheme
定在頁上使用的有效主題標識符。如果設置了StyleSheetTheme屬性,則單獨的控件可以重寫主題中包含的樣式設置。這樣,主題可以提供站點的整體外觀,同時,利用StyleSheetTheme屬性中包含的設置可以自定義頁及其各個控件的特定設置

TargetSchema
指定用於驗證頁內容的方案的名稱。此屬性僅起描述性的作用,而不會真正執行驗證;分析器將忽略此屬性

Theme
指定在頁上使用的有效主題標識符。如果設置Theme屬性時沒有使用StyleSheetTheme屬性,則將重寫控件上的單獨的樣式設置,允許您創建統一而一致的頁外觀

Title
指定在響應的 HTML<title>標記中呈現的頁的標題。也可以通過編程方式將標題作爲頁的屬性來訪問

Trace
指示是否啓用跟蹤。如果啓用了跟蹤,則爲true;否則爲false。默認值爲false

TraceMode
指示當啓用跟蹤時如何爲頁顯示跟蹤消息。可能的值爲SortByTime和SortByCategory。當啓用跟蹤時,默認值爲 SortByTime

Transaction
指示在頁上是否支持事務。可能的值有Disabled、NotSupported、Supported、Required和RequiresNew。默認值爲Disabled

常用屬性說明:

(1)AutoEventWireup屬性

該屬性指示頁的事件是否自動綁定。

ASP.NET 2.0默認爲true,ASP.NET 1.0和ASP.NET 1.1默認爲false。ASP.NET頁觸發的事件,如Init、Load等,在默認情況下,可以使用“Page_事件名”的命名約定將頁事件綁定到相應的方法,頁面編輯時ASP.NET將查找基於此命名約定的方法,並自動執行。

例如,如果要顯示聲明事件的處理程序,可以將AutoEventWireup屬性設置爲false。代碼如下:

<%@ Page Language="C#" AutoEventWireup="false" %>


(2)CodeFile屬性

該屬性指定指向頁引用的代碼隱藏文件的路徑。此屬性與Inherits屬性一起使用可以將代碼隱藏源文件與網頁相關聯。此屬性僅對編譯的頁有效。

例如:新添加一個.aspx頁時,設置該頁面代碼隱藏文件的路徑爲“Default2.aspx.cs”。代碼如下:

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default2.aspx.cs" Inherits="Default2" %>


說明:若要定義@Page指令的多個屬性,請使用一個空格分隔每個屬性/值對。對於特定屬性,不要在該屬性與其值相連的等號(=)兩側加空格。

(3)Language屬性

該屬性指定編譯頁面使用的語言。每頁只能使用和指定一種語言。

例如,指定ASP.NET頁編譯器使用Visual Basic作爲頁的服務器端代碼語言。代碼如下:

<%@ Page Language="VB" %>


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章