ASP.NET 指令语法大全

@ Page

定义 ASP.NET 页分析器和编译器使用的页特定（.aspx 文件）属性。

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

常见属性

Language ASP.NET 所使用的语言，一般为 C# 或 VB，一页只能使用一种语言。

AutoEventWireup 页的事件是否自动绑定，如果自动绑定则 Page_Load 等方法名将不是普通的方法而是与相应事件关联了的方法。可选值：true（默认）、false。

Buffer 是否启用服务器端缓存，若启用将提高 HTTP 输出性能。可选值：true（默认）、false。

ClassName 一个字符串，网页编译时使用这个字符串作为整个网页的类名，如果省略则编译时的类名基于网页文件名。

Debug 是否使用调试符号编译该页，开启调试会在一定程度上影响性能。可选值：true（默认）、false。请参见显示 ASP.NET 应用程序的错误。

EnableViewState 指示是否在页请求之间保持视图状态，请参见 EnableViewState 属性。可选值：true（默认）、false。

ValidateRequest 是否执行请求验证。可选值：true（默认）、false。请参见validateRequest。

Src 页的代码的源文件路径，ASP.NET 2.0 中，更好的做法是使用 CodeFile 和 Inherits。

CodeFile(或者CodeBehind) 页的代码的隐藏文件路径。此属性与 Inherits 属性一起使用可以将代码隐藏源文件与网页相关联。

Inherits 页继承的代码隐藏类。它可以是从 Page 类派生的任何类。它与 CodeFile 属性（包含指向代码隐藏类的源文件的路径）一起使用。

MasterPageFile 母版页路径。

Title 网页标题，这在使用母版时很有用。

@ Control

@ Control 指令语法的属性及意义与 @ Page 相同，只是属性略少些。该指令应用于用户控件文件（.ascx 文件），而 @ Page 应用于网页文件（.aspx 文件）。

常见属性

Language、AutoEventWireup、ClassName、Debug、EnableViewState、Src、CodeFile、Inherits (各属性的意义同@page指令的属性)

@ Import

将名称空间显式导入到 ASP.NET 应用程序文件（如网页、用户控件、母版页或 Global.asax 文件）中，以简化书写。

属性

Namespace 要导入的名称空间的完全限定名。

@ Implements

指示当前的 ASP.NET 应用程序文件（网页、用户控件或母版页）实现指定的 .NET Framework 接口。

属性

Interface 要在页或用户控件中实现的接口。

@ Register

在 ASP.NET 应用程序文件（包括网页、用户控件和母版页）中注册自定义控件。

属性

Assembly 用户控件的程序集，与 Src 选一使用。

Src 用户控件文件的位置，与 Assembly 选一使用。

Namespace 用户控件的名称空间。

TagPrefix 任意名称，指定标签前缀名称，如“<asp:ListBox”中的“asp”。

TagName 任意名称，指定标签名称，如“<asp:ListBox”中的“ListBox”。

@ Assembly

将程序集链接到 ASP.NET 应用程序页（例如网页、用户控件、母版页或 Global.asax 文件），使程序集的所有类和接口都在该页上可用。

属性

Name 要链接的程序集的名称，与 Src 选一使用。

Src 要动态编译和链接的源文件的路径，与 Name 选一使用。

@ OutputCache

控制网页文件（.aspx 文件）或用户控件文件（.ascx 文件）的输出缓存策略。

常见属性

Duration 页或用户控件进行缓存的时间（单位：秒）。

Shared 设置用户控件输出是否可以由多个网页文件共享，如果为 true，则多个 Web 窗体页可以访问缓存的用户控件输出，可选值：true、false（默认），该属性用于用户控件文件（.ascx 文件）。

@ Reference

对位于某个虚拟路径的另一个网页文件（.aspx 文件）、用户控件文件（.ascx 文件）或其它文件进行链接，链接后可用 Page.LoadControl 方法进行加载。

属性

Page 链接的网页文件（.aspx 文件）路径。

Control 链接的用户控件文件（.ascx 文件）路径。

VirtualPath 引用的虚拟路径。

@ Master

@ Master 指令语法的属性及意义与 @ Page 相同，只是属性略少些。该指令应用于母版文件（.master 文件），而 @ Page 应用于网页文件（.aspx 文件）。

常见属性

Language、AutoEventWireup、ClassName、Debug、EnableViewState、Src、CodeFile、Inherits、MasterPageFile

@ PreviousPageType

@ PreviousPageType 指令用于跨页传递。

属性

TypeName 将前一网页转换成 TypeName，与 VirtualPath 选一使用。

VirtualPath 指定 PreviousPage 属性为 VirtualPath 网页的类型，与 TypeName 选一使用。

@ MasterType

用于当通过 Master 属性访问 ASP.NET 母版页时，创建对该母版页的强类型引用。

属性

TypeName 将母版转换成 TypeName，与 VirtualPath 选一使用。

VirtualPath 指定 Master 属性为 VirtualPath 母版的类型，与 TypeName 选一使用。