ASP.NET Page指令的一些常用属性
Async
使页成为异步处理程序(即,导致页使用 IHttpAsyncHandler 的实现来处理请求)。
默认值为 false。
AsyncTimeOut
定义在处理异步任务时使用的超时时间间隔(以秒为单位)。默认值为 45 秒。
该值必须是整数。
AspCompat
当设置为 true 时,允许在单线程单元 (STA) 线程上执行页。这允许页调用 STA 组件,例如用 Microsoft Visual Basic 6.0 开发的组件。将该属性设为 true 还允许页调用 COM+ 1.0 版组件,该组件要求可以访问非托管 Active Server Pages (ASP) 内置对象。可以通过 ObjectContext 对象或 OnStartPage 方法访问它们。默认值为 false。
注意
将该属性设置为 true 可能导致页的性能降低。有关更多信息,请参见“备注”一节。
AutoEventWireup
指示页的事件是否自动绑定。如果启用了事件自动绑定,则为 true;否则为 false。默认值为 true。有关更多信息,请参见 ASP.NET Web 服务器控件事件模型。
Buffer
确定是否启用了 HTTP 响应缓冲。如果启用了页缓冲,则为 true;否则为 false。
默认值为 true。
ClassName
一个字符串,指定在请求页时将自动进行动态编译的页的类名。此值可以是任何有效的类名,并且可以包括类的完整命名空间(完全限定的类名)。如果未指定该属性的值,则已编译页的类名将基于页的文件名。
其他页可以通过使用 @ Reference 指令来引用分配给第一页的类名。
ClientTarget
指示 ASP.NET 服务器控件应该为其呈现内容的目标用户代理(通常是 Web 浏览器,例如 Microsoft Internet Explorer)。该值可以是应用程序配置文件的 <clientTarget> 节中定义的任何有效别名。
CodeBehind
指定包含与页关联的类的已编译文件的名称。该属性不能在运行时使用。
注意
提供此属性是为了与以前版本的 ASP.NET 的兼容,以实现代码隐藏功能。在 ASP.NET 2.0 版中,应改用 CodeFile 属性指定该源文件的名称,同时使用 Inherits 属性指定该类的完全限定名称。
CodeFile
指定指向页引用的代码隐藏文件的路径。此属性与 Inherits 属性一起使用可以将代码隐藏源文件与网页相关联。此属性仅对编译的页有效。
CodeFileBaseClass
指定页的基类及其关联的代码隐藏类的路径。此属性是可选的,但如果使用此属性,则必须同时使用 CodeFile 属性。如果希望实现以下共享方案,可使用该属性:在该共享方案中,您在基类中定义通用字段(可以选择性地定义关联事件)以引用在网页中声明的控件。出于 ASP.NET 代码生成模型的缘故,如果您在基类中定义字段时没有使用该属性,则编译时将为在网页中(在单独的分部类存根中)声明的控件生成新的成员定义,而您希望的方案将无法生效。但是,如果您使用 CodeFileBaseClass 属性将基类与页相关联,并且您的分部类(其名称分配给 Inherits 属性,并且其源文件由 CodeFile 属性引用)是从该基类继承的,则该基类中的字段在代码生成之后将能够引用页上的控件。
CodePage
指示用于响应的编码方案的值。该值是一个用作编码方案 ID 的整数。有关可能的 CodePage ID 的列表,请参见 Encoding 类。
CompilationMode
设置是否应使用指定多个枚举选项之一的字符串来编译页。默认值为 Always,因此,默认情况下编译 .aspx 页。有关详细信息,请参见 CompilationMode 枚举。