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