ASP.NET指令是指定可选设置的说明,例如注册自定义控件和页面语言.这些设置描述了.Net框架如何处理Web表单(.aspx)或用户控件(.ascx)页面.
声明指令的语法是:
<%@ directive_name attribute=value [attribute=value] %>
在本节中,我们将介绍ASP.NET指令,我们将在整个教程中使用大部分指令.
Application指令定义特定于应用程序的属性.它在global.aspx文件的顶部提供.
Application指令的基本语法是:
<%@ Application Language="C#" %>
Application指令的属性是:
属性 | 描述 |
---|---|
Inherits | 要继承的类的名称. |
Description | 应用程序的文本描述.解析器和编译器忽略了这一点. |
Language | 代码块中使用的语言. |
Assembly指令将程序集链接到页面或解析时的应用程序.这可以出现在用于应用程序范围链接的global.asax文件中,在页面文件中,用于链接到页面或用户控件的用户控件文件.
Assembly的基本语法指令是:
<%@ Assembly Name ="myassembly" %>
Assembly指令的属性是:
属性 | 描述 |
---|---|
Name | 要链接的程序集的名称. |
Src | 动态链接和编译的源文件的路径. |
控制指令与用户控件一起使用,并显示在用户控件(.ascx)文件中.
Control指令的基本语法是:
<%@ Control Language="C#" EnableViewState="false" %>
Control指令的属性是:
属性 | 描述 |
---|---|
AutoEventWireup | 布尔值,用于启用或禁用事件与处理程序的自动关联. |
ClassName | 控件的文件名. |
Debug | 启用或禁用使用调试符号进行编译的布尔值. |
Description | 控制页面的文本描述,被编译器忽略. |
EnableViewState | 布尔值,指示是否跨页面请求维护视图状态. |
Explicit | 对于VB语言,告诉编译器使用选项显式模式. |
Inherits | 控制页继承的类. |
Language | 代码和脚本的语言. |
Src | 代码隐藏类的文件名. |
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" %>
MasterType指令将类名指定给页面的Master属性,以使其成为可能强类型.
MasterType指令的基本语法是:
<%@ MasterType attribute="value"[attribute="value" ...] %>
OutputCache指令控制网页或用户控件的输出缓存策略./p>
OutputCache指令的基本语法是:
<%@ OutputCache Duration="15" VaryByParam="None" %>
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指令指定ac lass到页面,以便强类型页面.
示例PreviousPagetype指令的基本语法是:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>
Reference指令指示应编译另一个页面或用户控件并将其链接到当前页面.
Reference指令的基本语法是:
<%@ Reference Page ="somepage.aspx" %>
注册衍生产品用于注册自定义服务器控件和用户控件.
Register指令的基本语法是:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>