ASP.NET 指令是指定可選設定的說明,例如註冊一個自訂的控制和頁面的語言。這些設定介紹了NET Framework 如何處理單頁表單(.aspx)或使用者控制項(.ascx)網頁。
下達指令的基本語法:
<%@ directive_name attribute=value [attribute=value] %>
在這一部分中,我們將介紹ASP.NET 指令,同時在整個教學課程中套用大多數指令。
應用指令定義特定應用程式的屬性。它是在global.aspx 檔案的頂部提供。
應用程式指令的基本語法:
<%@ Application Language="C#" %>
應用程式指令的屬性:
屬性 | 描述 |
---|---|
Inherits | 從類別的名稱中繼承。 |
Description | 應用的文字描述。解析器和編譯器忽略這一點。 |
Language | 應用在程式碼組中的語言。 |
集合指令連結著一個網頁連結的元件或在分析時的應用程式。這可能會出現在整個應用程式類型連結Global.asax 檔案中,頁面檔案中,用於連結到另一個網頁的使用者控制項或使用者控制項中。
集合控制項的基本語法是:
<%@ Assembly Name ="myassembly" %>
集合控制項的屬性是:
屬性 | 描述 |
---|---|
Name | 被連結的集合組件的名稱。 |
Src | 來源文件被動態連結和編輯的路徑。 |
控制指令是與使用者控制項一同使用並出現在使用者控制項(.ascx)檔案中。
控制指令的基本語法是:
<%@ Control Language="C#" EnableViewState="false" %>
控制指令的屬性是:
屬性 | 描述 |
---|---|
AutoEventWireup | 允許或停用事件處理程序的自動關聯的布林值。 |
ClassName | 控件的檔案名稱。 |
Debug | 許或停用編輯調試符號的布林值。 |
Description | 控制頁面的文字說明,被編譯器忽略。 |
EnableViewState | 頁面請求為是否保持視圖狀態的布林值。 |
Explicit | 在VB 語言下,告知編輯器使用選項顯示模式。 |
Inherits | 控制頁面繼承的類別。 |
Language | 編碼和腳本的語言。 |
Src | 程式碼隱藏類別的檔案名稱。 |
Strict | 在VB 語言下,告知編輯器使用選項標準模式。 |
工具指令表示網頁,母版頁或使用者控制頁必須執行具有詳細說明的.Net 框架介面。
工具指令的基本語法是:
<%@ Implements Interface="interface_name" %>
導入指令導入一個命名空間到使用者控制應用程式的頁面。如果在global.asax 檔案中指定了Import 指令,那麼會將其套用到整個應用程式。如果它是在使用者控制頁面的網頁中,則會將其套用到該網頁或控制項中。
導入指令的基本語法是:
<%@ namespace="System.Drawing" %>
主要指令指定了一個頁面檔案作為主頁。
樣本主頁指令的基本語法是:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>
MasterType 指令指定一個類別名稱到頁面的主屬性,強化其類型。
母版式指令的基本語法是:
<%@ MasterType attribute="value"[attribute="value" ...] %>
輸出快取指令控制網頁或使用者控制項的輸出快取策略。
輸出緩存指令的基本語法:
<%@ OutputCache Duration="15" VaryByParam="None" %>
頁面指令定義特定的頁面分析器和編譯器的頁面檔案的屬性。
頁面指令的基本語法是:
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>
頁面指令的屬性是:
屬性 | 描述 |
---|---|
AutoEventWireup | 允許或停用正在自動綁定到方法頁面事件的布林值;例如,Page_Load。 |
Buffer | 允許或停用HTTP 回應緩衝的布林值。 |
ClassName | 頁面的類別名稱。 |
ClientTarget | 伺服器控制項應呈現的內容的瀏覽器 |
CodeFile | 代碼隱藏檔案的名稱。 |
Debug | 允許或禁止使用調試符號編譯的布林值。 |
Description | 頁面的文件說明,由解析器忽略。 |
EnableSessionState | 啟用或停用頁面會話狀態為唯讀。 |
EnableViewState | 允許或禁止跨頁請求視圖狀態的布林值。 |
ErrorPage | 未經處理的頁面異常發生的情況下的重定位址。 |
Inherits | 後台程式碼或其他類別的名稱。 |
Language | 代碼的程式語言。 |
Src | 後台程式碼類別的檔案名稱。 |
Trace | 啟用或停用追蹤。 |
TraceMode | 表示追蹤資訊的顯示方式,並依照時間或類別排序。 |
Transaction | 表示交易是否被支持。 |
ValidateRequest | 表示所有輸入資料是否被有效驗證為hardcoded 清單值得布林值。 |
前頁型指令為一個頁面指派類別,使得該頁面類型被強化。
前頁型指令的樣本的基本語法:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>
參考指令表明另一個頁面或使用者控制項應編譯和連結到目前頁面。
參考指令的基本語法是:
<%@ Reference Page ="somepage.aspx" %>
註冊指令用於註冊自訂伺服器控制項和使用者控制項。
註冊指令的基本語法為:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>