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

编号 属性 描述
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" %>

上一篇: ASP.NET基本控件 下一篇: ASP.NET管理状态