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 指令的屬性為

Assembly 指令在解析時將程式集連結到頁面或應用程式。這可以出現在 global.asax 檔案中以進行應用程式範圍的連結，也可以出現在頁面檔案、使用者控制元件檔案中以進行連結到頁面或使用者控制元件。

Assembly 指令的基本語法為

<%@ Assembly Name ="myassembly" %>

Assembly 指令的屬性為

屬性	描述
Name	要連結的程式集的名稱。
Src	要連結並動態編譯的原始檔的路徑。

Control 指令與使用者控制元件一起使用，並出現在使用者控制元件 (.ascx) 檔案中。

Control 指令的基本語法為

<%@ Control Language="C#"  EnableViewState="false" %>

Control 指令的屬性為

屬性	描述
AutoEventWireup	啟用或停用將事件自動關聯到處理程式的布林值。
ClassName	控制元件的檔名。
Debug	啟用或停用使用除錯符號進行編譯的布林值。
描述	控制元件頁面的文字描述，編譯器會忽略。
EnableViewState	指示是否在頁面請求之間維護檢視狀態的布林值。
Explicit	對於 VB 語言，告訴編譯器使用 Option Explicit 模式。
Inherits	控制元件頁面繼承的類。
Language	程式碼和指令碼的語言。
Src	程式碼隱藏類的檔名。
Strict	對於 VB 語言，告訴編譯器使用 Option Strict 模式。

Implement 指令指示網頁、母版頁或使用者控制元件頁面必須實現指定的 .Net 框架介面。

Implements 指令的基本語法為

<%@ Implements  Interface="interface_name" %>

Import 指令將名稱空間匯入到網頁、使用者控制元件頁面或應用程式中。如果在 global.asax 檔案中指定了 Import 指令，則它將應用於整個應用程式。如果它位於頁面或使用者控制元件頁面中，則它將應用於該頁面或控制元件。

Import 指令的基本語法為

<%@ namespace="System.Drawing" %>

Master 指令將頁面檔案指定為母版頁。

示例 MasterPage 指令的基本語法為

<%@ MasterPage Language="C#"  AutoEventWireup="true"  CodeFile="SiteMater.master.cs" Inherits="SiteMaster"  %>

MasterType 指令將類名分配給頁面的 Master 屬性，使其成為強型別。

MasterType 指令的基本語法為

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

OutputCache 指令控制網頁或使用者控制元件的輸出快取策略。

OutputCache 指令的基本語法為

<%@ OutputCache Duration="15" VaryByParam="None"  %>

Page 指令定義特定於頁面檔案的屬性，供頁面解析器和編譯器使用。

Page 指令的基本語法為

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

Page 指令的屬性為

屬性	描述
AutoEventWireup	啟用或停用自動繫結到方法的頁面事件的布林值；例如，Page_Load。
Buffer	啟用或停用 HTTP 響應緩衝的布林值。
ClassName	頁面的類名。
ClientTarget	伺服器控制元件應為其呈現內容的瀏覽器。
CodeFile	程式碼隱藏檔案的檔名。
Debug	啟用或停用使用除錯符號進行編譯的布林值。
描述	頁面的文字描述，解析器會忽略。
EnableSessionState	啟用、停用或使會話狀態只讀。
EnableViewState	啟用或停用頁面請求之間檢視狀態的布林值。
ErrorPage	如果發生未處理的頁面異常，則重定向的 URL。
Inherits	程式碼隱藏或其他類的名稱。
Language	程式碼的程式語言。
Src	程式碼隱藏類的檔名。
Trace	啟用或停用跟蹤。
TraceMode	指示如何顯示跟蹤訊息，以及按時間或類別排序。
Transaction	指示是否支援事務。
ValidateRequest	指示是否根據硬編碼值列表驗證所有輸入資料的布林值。

PreviousPageType 指令將類分配給頁面，以便頁面成為強型別。

示例 PreviousPagetype 指令的基本語法為

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

Reference 指令指示應編譯另一個頁面或使用者控制元件並連結到當前頁面。

Reference 指令的基本語法為

<%@ Reference Page ="somepage.aspx" %>

<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>

列印頁面