指令(Directives)
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" %>