ASP.NET Page指令的一些常用属性

ASP.NET Page指令的一些常用属性,转载自MSDN

　　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 枚举。