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要继承的类的名称.
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指令

MasterType指令将类名指定给页面的Master属性,以使其成为可能强类型.

MasterType指令的基本语法是:

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

OutputCache指令

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指令

PreviousPageType指令指定ac lass到页面,以便强类型页面.

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

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

参考指令

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

Reference指令的基本语法是:

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

注册指令

注册衍生产品用于注册自定义服务器控件和用户控件.

Register指令的基本语法是:

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