ASP.Net教學 » ASP.NET指令

ASP.NET指令

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" %>