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 指令的属性是：

属性	描述
Inherits	要继承的类的名称。
Description	应用程序的文本描述。解析器和编译器会忽略这一点。
Language	代码块中使用的语言。

Assembly 指令

Assembly 指令在解析时将程序集链接到页面或应用程序。这可能出现在用于应用程序范围链接的 global.asax 文件中、页面文件中、用于链接到页面或用户控件的用户控制文件中。

汇编指令的基本语法是：

<%@ Assembly Name ="myassembly" %>

Assembly 指令的属性是：

属性	描述
Name	要链接的程序集的名称。
Src	要动态链接和编译的源文件的路径。

Control 指令

Control 指令与用户控件一起使用，并出现在用户控件 (.ascx) 文件中。

Control 指令的基本语法是：

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

Control 指令的属性是：

属性	描述
AutoEventWireup	启用或禁用事件与处理程序自动关联的布尔值。
ClassName	控件的文件名。
Debug	启用或禁用使用调试符号进行编译的布尔值。
Description	控制页的文本描述，被编译器忽略。
EnableViewState	布尔值，指示是否跨页面请求维护视图状态。
Explicit	对于VB语言，告诉编译器使用选项显式模式。
Inherits	控制页面继承的类。
Language	代码和脚本的语言。
Src	代码隐藏类的文件名。
Strict	对于 VB 语言，告诉编译器使用选项严格模式。

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

MasterType 指令

MasterType 指令将类名分配给页面的 Master 属性，以使其成为强类型。

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 指令的属性是：

属性	描述
AutoEventWireup	布尔值，用于启用或禁用自动绑定到方法的页面事件；例如，Page_Load。
Buffer	启用或禁用 HTTP 响应缓冲的布尔值。
ClassName	页面的类名称。
ClientTarget	服务器控件应为其呈现内容的浏览器。
CodeFile	文件背后代码的名称。
Debug	启用或禁用带有调试符号的编译的布尔值。
Description	页面的文本描述，被解析器忽略。
EnableSessionState	它启用、禁用会话状态或使会话状态变为只读。
EnableViewState	跨页面请求启用或禁用视图状态的布尔值。
ErrorPage	发生未处理的页面异常时重定向的URL。
Inherits	隐藏代码或其他类的名称。
Language	代码的编程语言。
Src	类背后代码的文件名。
Trace	它启用或禁用跟踪。
TraceMode	它指示如何显示跟踪消息，并按时间或类别排序。
Transaction	表示是否支持事务。
ValidateRequest	布尔值，指示是否根据硬编码值列表验证所有输入数据。

PreviousPageType 指令

PreviousPageType 指令为页面分配一个类，以便该页面是强类型的。

示例 PreviousPagetype 指令的基本语法是：

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

Reference 指令

Reference 指令指示应编译另一个页面或用户控件并将其链接到当前页面。

Reference 指令的基本语法是：

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

Register 指令

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

ASP.NET 教程