ASP.NET 指令
ASP.NET 指令是指定可选设置的指令,例如注册自定义控件和页面语言。这些设置描述了 .Net 框架如何处理网络表单 (.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 语言,告诉编译器使用选项严格模式。 |
实施指令
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 指令的基本语法是:
<%@ 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" %>