Asp.net 简明教程
ASP.NET - Directives
ASP.NET 指令是用于指定可选设置(如注册自定义控件和页面语言)的指令。这些设置描述了.Net 框架如何处理 Web 窗体(.aspx)或用户控件(.ascx)页面。
声明指令的语法:
<%@ directive_name attribute=value [attribute=value] %>
在本节中,我们将只介绍 ASP.NET 指令,并在整个教程中使用这些指令的大部分。
The Application Directive
Application 指令定义特定于应用程序的属性。它在 global.aspx 文件的顶部提供。
Application 指令的基本语法为:
<%@ Application Language="C#" %>
Application 指令的属性为:
Attributes |
Description |
Inherits |
要从中继承的类的名称。 |
Description |
应用程序的文本描述。解析器和编译器忽略此属性。 |
Language |
代码块中使用的语言。 |
The Assembly Directive
Assembly 指令在解析时将程序集链接到页面或应用程序。这可能会显示在用于应用程序范围链接的 global.asax 文件中、页面文件中、用户控件文件中(用于链接到页面或用户控件)。
Assembly 指令的基本语法为:
<%@ Assembly Name ="myassembly" %>
Assembly 指令的属性为:
Attributes |
Description |
Name |
要链接的程序集的名称。 |
Src |
要链接并动态编译的源文件的路径。 |
The Control Directive
Control 指令与用户控件一起使用,并显示在用户控件 (.ascx) 文件中。
Control 指令的基本语法为:
<%@ Control Language="C#" EnableViewState="false" %>
Control 指令的属性为:
Attributes |
Description |
AutoEventWireup |
布尔值,用于启用或禁用自动将事件与处理程序相关联。 |
ClassName |
控件的文件名。 |
Debug |
布尔值,用于启用或禁用使用调试符号进行编译。 |
Description |
控件页面的文本描述,由编译器忽略。 |
EnableViewState |
布尔值,用于指示是否跨页请求维护视图状态。 |
Explicit |
对于 VB 语言,指示编译器使用显式选项模式。 |
Inherits |
控件页面从中继承的类。 |
Language |
用于代码和脚本的语言。 |
Src |
代码隐藏类使用文件名。 |
Strict |
对于 VB 语言,告诉编译器使用严格模式选项。 |
The Implements Directive
Implement 指令表示 Web 页面、母版页或用户控件页面必须实现指定的 .Net 框架接口。
implements 指令的基本语法为:
<%@ Implements Interface="interface_name" %>
The Import Directive
Import 指令将命名空间导入 Web 页面、应用程序的用户控件页面。如果在 global.asax 文件中指定 Import 指令,则将其应用于整个应用程序。如果将其包含在用户控件页面中,则将其应用于该页面或控件。
import 指令的基本语法为:
<%@ namespace="System.Drawing" %>
The Master Directive
Master 指令指定一个页面文件作为母版页。
范例 MasterPage 指令的基本语法为:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>
The MasterType Directive
MasterType 指令将类名称分配给页面的 Master 属性,以使其强类型化。
MasterType 指令的基本语法为:
<%@ MasterType attribute="value"[attribute="value" ...] %>
The OutputCache Directive
OutputCache 指令控制某个 Web 页面或用户控件的输出缓存策略。
OutputCache 指令的基本语法为:
<%@ OutputCache Duration="15" VaryByParam="None" %>
The Page Directive
Page 指令为页面解析器和编译器定义页面文件特有的属性。
Page 指令的基本语法为:
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>
Page 指令的属性:
Attributes |
Description |
AutoEventWireup |
用于启用或禁用与方法自动绑定的页面事件(例如 Page_Load)的布尔值。 |
Buffer |
用于启用或禁用 HTTP 响应缓冲的布尔值。 |
ClassName |
页面的类名称。 |
ClientTarget |
服务器控件应该为其呈现内容的浏览器。 |
CodeFile |
代码隐藏文件的文件名。 |
Debug |
启用或禁用带调试符号的编译的布尔值。 |
Description |
页面文本描述,被解析器忽略。 |
EnableSessionState |
启用、禁用或使会话状态只读。 |
EnableViewState |
在页面请求中启用或禁用视图状态的布尔值。 |
ErrorPage |
如果发生未处理的页面异常的重新定向 URL。 |
Inherits |
代码隐藏或其他类的名称。 |
Language |
代码的编程语言。 |
Src |
代码隐藏类的文件名。 |
Trace |
启用或禁用跟踪。 |
TraceMode |
它指示如何显示跟踪消息,以及按时间或类别排序。 |
Transaction |
指示是否支持交易。 |
ValidateRequest |
指示是否针对硬编码的值列表验证所有输入数据的布尔值。 |
The PreviousPageType Directive
PreviousPageType 指令为页面分配一个类,以便该页面强类型化。
示例 PreviousPagetype 指令的基本语法为:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>