asp.net指令是指定可选设置的指令,例如注册自定义控件和页面语言。 这些设置描述了.net框架如何处理web窗体(.aspx
)或用户控件(.ascx
)页面。
声明一个指令的语法是:
<%@ directive_name attribute=value [attribute=value] %>
在本节中,我们将只介绍asp.net指令,在整个教程中将会使用大部分这些指令。
application
指令定义特定于应用程序的属性。它位于global.aspx
文件的顶部。
application
指令的基本语法是:
<%@ application language="c#" %>
application
指令的属性是:
编号 | 属性 | 描述 |
---|---|---|
1 | inherits |
从中继承类的名称。 |
2 | description |
应用程序的文本描述。解析器和编译器忽略这一点。 |
3 | language |
在代码块中使用的语言。 |
assembly
指令在解析时将程序集链接到页面或应用程序。 这可能出现在用于应用程序范围链接的global.asax
文件中,在页面文件中出现用于链接到页面或用户控件的用户控制文件。
assembly
指令的基本语法是:
<%@ assembly name ="myassembly" %>
assembly
指令的属性是:
编号 | 属性 | 描述 |
---|---|---|
1 | name |
要链接的程序集的名称。 |
2 | src |
源文件的路径被动态链接和编译。 |
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
指令指示网页,母版页或用户控制页面必须实现指定的.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" %>
import
指令的基本语法是:
<%@ namespace="system.drawing" %>
mastertype
指令为页面的主属性分配一个类名,以使其强类型化。
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
指令的属性是:
编号 | 属性 | 描述 |
---|---|---|
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 attribute="value"[attribute="value" ...] %>
reference
指令指示应编译另一个页面或用户控件并将其链接到当前页面。
reference
指令的基本语法是:
<%@ reference page ="somepage.aspx" %>
register
派生用于注册自定义服务器控件和用户控件。
register
指令的基本语法是:
<%@ register src="~/footer.ascx" tagname="footer" tagprefix="tfooter" %>