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" ...]   %>

The Reference Directive

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

Reference 指令的基本语法为:

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

The Register Directive

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

Register 指令的基本语法:

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