asp.net中的@page指令

@Page指令 

@Page指令允许开发人员为页面指定多个配置选项，并且该指令只能在Web窗体页中使用。每个.aspx文件只能包含一条@Page指令。@Page指令可以指定：页面中代码的服务器编程语言；页面是将服务器代码直接包含在其中（即单文件页面），还是将代码包含在单独的类文件中（即代码隐藏页面）；调试和跟踪选项，以及页面是否为某母版页的内容页。

语法：

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

attribute 为@Page指令的属性。@Page指令语法中各属性的说明如表所示。

表  @Page指令属性说明

属性
描述

Async
使页成为异步处理程序默认值为false

AsyncTimeOut
定义在处理异步任务时使用的超时时间间隔（以秒为单位）。默认值为45秒。该值必须是整数

AutoEventWireup
指示页的事件是否自动绑定。如果启用了事件自动绑定，则为true；否则为false。默认值为true

Buffer
确定是否启用了HTTP响应缓冲。如果启用了页缓冲，则为true；否则为false。默认值为true

ClassName
一个字符串，指定在请求页时将自动进行动态编译的页的类名。此值可以是任何有效的类名，并且可以包括类的完整命名空间（完全限定的类名）。如果未指定该属性的值，则已编译页的类名将基于页的文件名

CodeFile
指定指向页引用的代码隐藏文件的路径

CodeFileBaseClass
指定页的基类及其关联的代码隐藏类的路径。此属性是可选的，但如果使用此属性，则必须同时使用CodeFile属性

CodePage
指示用于响应的编码方案的值

CompilationMode
设置是否应使用指定多个枚举选项之一的字符串来编译页。默认值为 Always，因此，默认情况下编译 .aspx 页

Culture
指示页的区域性设置。该属性的值必须是有效的区域性ID。注意，LCID和Culture属性是互相排斥的；如果使用了其中一个属性，就不能在同一页中使用另一个属性

Debug
指示是否应使用调试符号编译该页。如果应使用调试符号编译该页，则为 true；否则为 false。由于此设置影响性能，因此只应在开发期间将此属性设置为 true

Description
提供该页的文本说明。ASP.NET分析器忽略该值

EnableEventValidation
在回发方案中启用事件验证。如果验证事件，则为true；否则为false。默认值为true

EnableSessionState
定义页的会话状态要求。如果启用了会话状态，则为true；如果可以读取会话状态但不能进行更改，则为ReadOnly；否则为false。默认值为true。这些值不区分大小写

EnableTheming
指示是否在页上使用主题。如果使用主题，则为true；否则为false。默认值为true

EnableViewState
指示是否在页请求之间保持视图状态。如果要保持视图状态，则为true；否则为false。默认值为true

ErrorPage
定义在出现未处理页异常时用于重定向的目标URL

Inherits
定义供页继承的代码隐藏类。它与CodeFile 属性（包含指向代码隐藏类的源文件的路径）一起使用

Language
指定在对页中的所有内联呈现（<% %> 和 <%= %>）和代码声明块进行编译时使用的语言。值可以表示任何.NET Framework支持的语言，如C# 

LCID
定义Web窗体页的区域设置标识符

MaintainScrollPosition

OnPostback
设置在回发后是否将客户端的页面返回到请求前的同一位置，默认为false

MasterPageFile
设置内容页的母版页或嵌套母版页的路径。支持相对路径和绝对路径

ResponseEncoding
指示用于包含页内容的HTTP响应的编码方案的名称。分配给该属性的值是有效的编码名称

SmartNavigation
指示页是否支持Internet Explorer 5.5或更高版本的智能导航功能。如果启用了智能导航，则为true；否则为false。默认值为false

Src
指定包含链接到页的代码的源文件的路径。在链接的源文件中，可以选择将页的编程逻辑包含在类中或代码声明块中。可以使用Src属性将生成提供程序链接到页

StyleSheetTheme
定在页上使用的有效主题标识符。如果设置了StyleSheetTheme属性，则单独的控件可以重写主题中包含的样式设置。这样，主题可以提供站点的整体外观，同时，利用StyleSheetTheme属性中包含的设置可以自定义页及其各个控件的特定设置

TargetSchema
指定用于验证页内容的方案的名称。此属性仅起描述性的作用，而不会真正执行验证；分析器将忽略此属性

Theme
指定在页上使用的有效主题标识符。如果设置Theme属性时没有使用StyleSheetTheme属性，则将重写控件上的单独的样式设置，允许您创建统一而一致的页外观

Title
指定在响应的 HTML<title>标记中呈现的页的标题。也可以通过编程方式将标题作为页的属性来访问

Trace
指示是否启用跟踪。如果启用了跟踪，则为true；否则为false。默认值为false

TraceMode
指示当启用跟踪时如何为页显示跟踪消息。可能的值为SortByTime和SortByCategory。当启用跟踪时，默认值为 SortByTime

Transaction
指示在页上是否支持事务。可能的值有Disabled、NotSupported、Supported、Required和RequiresNew。默认值为Disabled

常用属性说明：

（1）AutoEventWireup属性

该属性指示页的事件是否自动绑定。

ASP.NET 2.0默认为true，ASP.NET 1.0和ASP.NET 1.1默认为false。ASP.NET页触发的事件，如Init、Load等，在默认情况下，可以使用“Page_事件名”的命名约定将页事件绑定到相应的方法，页面编辑时ASP.NET将查找基于此命名约定的方法，并自动执行。

例如，如果要显示声明事件的处理程序，可以将AutoEventWireup属性设置为false。代码如下：

<%@ Page Language="C#" AutoEventWireup="false" %>

（2）CodeFile属性

该属性指定指向页引用的代码隐藏文件的路径。此属性与Inherits属性一起使用可以将代码隐藏源文件与网页相关联。此属性仅对编译的页有效。

例如：新添加一个.aspx页时，设置该页面代码隐藏文件的路径为“Default2.aspx.cs”。代码如下：

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default2.aspx.cs" Inherits="Default2" %>

说明：若要定义@Page指令的多个属性，请使用一个空格分隔每个属性/值对。对于特定属性，不要在该属性与其值相连的等号(=)两侧加空格。

（3）Language属性

该属性指定编译页面使用的语言。每页只能使用和指定一种语言。

例如，指定ASP.NET页编译器使用Visual Basic作为页的服务器端代码语言。代码如下：

<%@ Page Language="VB" %>