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