当前位置: 首页 > 文档资料 > ASP.NET 中文教程 >

指令(Directives)

优质
小牛编辑
125浏览
2023-12-01

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要动态链接和编译的源文件的路径。

控制指令

control指令与用户控件一起使用,并显示在用户控件(.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指令将页面文件指定为mater页面。

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

<%@ MasterPage Language="C#"  AutoEventWireup="true"  CodeFile="SiteMater.master.cs" Inherits="SiteMaster"  %>

MasterType指令

MasterType指令将类名分配给页面的Master属性,以使其强类型化。

MasterType指令的基本语法是:

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

OutputCache指令

OutputCache指令控制网页或用户控件的输出缓存策略。

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指令为页面分配一个类,以便强类型页面。

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

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

参考指令

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

Reference指令的基本语法是:

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

注册指令

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

Register指令的基本语法是:

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