ASP.NET指令是指定可選設(shè)置的指令,例如注冊自定義控件和頁面語言。 這些設(shè)置描述了.Net框架如何處理Web窗體(.aspx)或用戶控件(.ascx)頁面。
聲明一個指令的語法是:
<%@ directive_name attribute=value [attribute=value] %>
在本節(jié)中,我們將只介紹ASP.NET指令,在整個教程中將會使用大部分這些指令。
Application指令定義特定于應(yīng)用程序的屬性。它位于global.aspx文件的頂部。
Application指令的基本語法是:
<%@ Application Language="C#" %>
Application指令的屬性是:
| 編號 | 屬性 | 描述 |
|---|---|---|
| 1 | Inherits |
從中繼承類的名稱。 |
| 2 | Description |
應(yīng)用程序的文本描述。解析器和編譯器忽略這一點。 |
| 3 | Language |
在代碼塊中使用的語言。 |
Assembly指令在解析時將程序集鏈接到頁面或應(yīng)用程序。 這可能出現(xiàn)在用于應(yīng)用程序范圍鏈接的global.asax文件中,在頁面文件中出現(xiàn)用于鏈接到頁面或用戶控件的用戶控制文件。
Assembly指令的基本語法是:
<%@ Assembly Name ="myassembly" %>
Assembly指令的屬性是:
| 編號 | 屬性 | 描述 |
|---|---|---|
| 1 | Name |
要鏈接的程序集的名稱。 |
| 2 | Src |
源文件的路徑被動態(tài)鏈接和編譯。 |
Control指令與用戶控件一起使用,并出現(xiàn)在用戶控件(.ascx)文件中。
Control指令的基本語法是:
<%@ Control Language="C#" EnableViewState="false" %>
Control指令的屬性是:
| 編號 | 屬性 | 描述 |
|---|---|---|
| 1 | AutoEventWireup |
這是一個布爾值,用于啟用或禁用事件與處理程序的自動關(guān)聯(lián)。 |
| 2 | ClassName |
控件的文件名。 |
| 3 | Debug |
啟用或禁用使用調(diào)試符號編譯的布爾值。 |
| 4 | Description |
控制頁面的文本描述,被編譯器忽略。 |
| 5 | EnableViewState |
指示頁面請求是否維持視圖狀態(tài)的布爾值。 |
| 6 | Explicit |
對于VB語言,告訴編譯器使用選項顯式模式。 |
| 7 | Inherits |
控制頁從其繼承的類。 |
| 8 | Language |
代碼和腳本的語言。 |
| 9 | Src |
代碼隱藏類的文件名。 |
| 10 | Strict |
對于VB語言,告訴編譯器使用選項strict模式。 |
Implement指令指示網(wǎng)頁,母版頁或用戶控制頁面必須實現(xiàn)指定的.Net框架接口。
implements指令的基本語法是:
<%@ Implements Interface="interface_name" %>
Import指令將命名空間導(dǎo)入到應(yīng)用程序的用戶控制頁面的網(wǎng)頁中。 如果在global.asax文件中指定了Import指令,則將其應(yīng)用于整個應(yīng)用程序。如果它位于用戶控制頁面的頁面中,則將其應(yīng)用于該頁面或控件。
Import指令的基本語法是:
<%@ namespace="System.Drawing" %>
Master指令將頁面文件指定為主頁面。
MasterPage指令的基本語法是:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>
Import指令的基本語法是:
<%@ namespace="System.Drawing" %>
MasterType指令為頁面的主屬性分配一個類名,以使其強(qiáng)類型化。
MasterType指令的基本語法是:
<%@ MasterType attribute="value"[attribute="value" ...] %>
OutputCache指令控制網(wǎng)頁或用戶控件的輸出緩存策略。OutputCache指令的基本語法是:
<%@ OutputCache Duration="15" VaryByParam="None" %>
Page指令為頁面解析器和編譯器定義特定于頁面文件的屬性。
Page指令的基本語法是:
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>
Page指令的屬性是:
| 編號 | 屬性 | 描述 |
|---|---|---|
| 1 | AutoEventWireup |
啟用或禁用正在自動綁定到方法的頁面事件的布爾值; 例如Page_Load。 |
| 2 | Buffer |
啟用或禁用HTTP響應(yīng)緩沖的布爾值。 |
| 3 | ClassName |
頁面的類名稱。 |
| 4 | ClientTarget |
服務(wù)器控制的瀏覽器應(yīng)呈現(xiàn)內(nèi)容。 |
| 5 | CodeFile |
文件后面的代碼的名稱。 |
| 6 | Debug |
使用調(diào)試符號啟用或禁用編譯的布爾值。 |
| 7 | Description |
頁面的文本描述,被解析器忽略。 |
| 8 | EnableSessionState |
它啟用,禁用或使會話狀態(tài)為只讀。 |
| 9 | EnableViewState |
在頁面請求中啟用或禁用視圖狀態(tài)的布爾值。 |
| 10 | ErrorPage |
如果發(fā)生未處理的頁面異常,則重定向的URL。 |
| 11 | Inherits |
后面的代碼或其他類的名稱。 |
| 12 | Language |
代碼的編程語言。 |
| 13 | Src |
類后面的代碼的文件名。 |
| 14 | Trace |
它啟用或禁用跟蹤。 |
| 15 | TraceMode |
它指示如何顯示跟蹤消息,并按時間或類別進(jìn)行排序。 |
| 16 | Transaction |
它指示是否支持事務(wù)。 |
| 17 | ValidateRequest |
表示所有輸入數(shù)據(jù)是否針對硬編碼值列表進(jìn)行驗證的布爾值。 |
PreviousPageType指令為一個頁面分配一個類,以便強(qiáng)制輸入頁面。
PreviousPagetype指令的基本語法是:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>
Reference指令指示應(yīng)編譯另一個頁面或用戶控件并將其鏈接到當(dāng)前頁面。
Reference指令的基本語法是:
<%@ Reference Page ="somepage.aspx" %>
Register派生用于注冊自定義服務(wù)器控件和用戶控件。
Register指令的基本語法是:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>