ASP.NET 指令

ASP.NET 指令是指定可选设置的指令，例如注册自定义控件和页面语言。这些设置描述了 .Net 框架如何处理 Web 表单 (.aspx) 或用户控件 (.ascx) 页面。

声明指令的语法是：

<%@  directive_name attribute=value  [attribute=value]  %>

在本节中，我们将只介绍 ASP.NET 指令，并且我们将在整个教程中使用这些指令中的大部分。

应用指令

Application 指令定义了特定于应用程序的属性。它位于 global.aspx 文件的顶部。

Application 指令的基本语法是：

<%@ Application Language="C#" %>

Application 指令的属性是：

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

大会指令

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

汇编指令的基本语法是：

<%@ Assembly Name ="myassembly" %>

汇编指令的属性是：

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

控制指令

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

Control 指令的基本语法是：

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

Control 指令的属性是：

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

实施指令

实现指令指示网页、母版页或用户控制页必须实现指定的 .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 指令

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

MasterType 指令的基本语法是：

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

输出Cache 指令

输出Cache 指令控制网页或用户控件的输出缓存策略。

输出Cache 指令的基本语法是：

<%@ 输出Cache Duration="15" VaryByParam="None"  %>

页面指令

Page 指令为页面解析器和编译器定义特定于页面文件的属性。

Page 指令的基本语法是：

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

Page 指令的属性是：

属性	描述
自动事件连线	启用或禁用自动绑定到方法的页面事件的布尔值；例如，Page_Load。
Buffer	启用或禁用 HTTP 响应缓冲的布尔值。
班级名称	页面的类名。
客户目标	服务器控件应为其呈现内容的浏览器。
CodeFile	代码隐藏文件的名称。
Debug	使用调试符号启用或禁用编译的布尔值。
描述	页面的文本描述，被解析器忽略。
启用会话状态	它启用、禁用或使会话状态为只读。
启用视图状态	启用或禁用跨页面请求的视图状态的布尔值。
错误页面	如果发生未处理的页面异常，则重定向 URL。
Inherits	后面的代码或其他类的名称。
Language	代码的编程语言。
Src	类后面代码的文件名。
Trace	它启用或禁用跟踪。
跟踪模式	它指示如何显示跟踪消息，并按时间或类别排序。
交易	它指示是否支持事务。
验证请求	指示是否所有输入数据都针对硬编码的值列表进行验证的布尔值。

PreviousPageType 指令

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

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

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

参考指令

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

Reference 指令的基本语法是：

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

注册指令

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

< 上一篇（ASP.NET 基本控件）

下一篇（ASP.NET 管理状态） >

ASP.NET 教程