asp页面指令与事件.doc

页面指令和事件时间:2010-01-09 12:01:49来源:网络 作者:未知 点击:437次 Page指令  定义页面属性Page指令 定义页面属性Page指令允许为ASP.NET页面(.aspx)指定解析和编译页面时使用的属性和值。这是最常用的指令。ASP.NET页面是ASP.NET的一个重要部分，所以它有许多属性。表3-4总结了Page指令的可用属性。表 3-4属 性说 明 AspCompat 若其值为True，就允许页面在单线程的单元中执行，这个属性的默认设置是False。 Async 指定ASP.NET页面是同步或异步处理 AutoEventWireUp 设置为True时，指定页面事件自动触发。这个属性的默认设置是True Buffer 设置为True时，支持HTTP响应缓存。这个属性的默认设置是True ClassName 指定编译页面时绑定到页面上的类名 CodeFile 引用与页面相关的后台编码文件 CodePage 指定响应的代码页面值 CompilerOptions 编译器字符串，指定页面的编译选项 CompileWith 包含一个String值，指向所使用的后台编码文件 ContentType 把响应的HTTP内容类型定义为标准MIME类型 Culture 指定页面的文化设置。ASP.NET 2.0允许把Culture 属性的值设置为Auto ，支持自动检测需要的文化 Debug 设置为True时，用调试符号编译页面 Description 提供页面的文本描述。ASP.NET解析器忽略这个属性及其值 EnableSessionState 设置为True时，支持页面的会话状态，其默认设置是True EnableTheming 设置为True时，页面可以使用主题。其默认设置是False. EnableViewState 设置为True时，在页面中维护视图状态，其默认设置是True EnableViewStateMac 设置为True时，当用户回送页面时，页面会在视图状态上进行机器范围内的身份验证，其默认设置是False ErrorPage 为所有未处理的页面异常指定用于发送信息的URL Explicit 设置为True时，支持Visual Basic的Explicit选项。其默认设置是False Language 定义内置显示和脚本块所使用的语言 LCID 为Web Form的页面定义本地标识符 LinePragmas Boolean值，指定得到的程序集是否使用行附注 MasterPageFile 带一个 String 值，指向页面所使用的master页面的地址。这个属性在内容页面中使用 MaintainScrollPositionOnPostback 带一个Boolean 值，表示在回送页面时，页面是位于相同的滚动位置上，还是在最高的位置上重新生成页面 PersonalizationProvider 带一个 String 值，指定把个性化信息应用于页面时所使用的个性化提供程序名 ResponseEncoding 指定页面内容的响应编码 (续表) 属 性说 明 SmartNavigation 指定是否为功能更丰富的浏览器激活ASP.NET智能导航功能。它把回送信息返回到页面的当前位置，其默认值是False Src 指向类的源文件，用于所显示的页面的后台编码 Strict 设置为True时，使用Visual Basic Strict模式编译页面，其默认值是False Theme 使用ASP.NET 2.0的主题功能，把指定的主题应用于页面 Title 应用页面的标题。这个属性主要用于必须应用页面标题的内容页面，而不是应用master页面中指定内容的页面 Trace 设置为True时，激活页面跟踪，其默认值是False TraceMode 指定激活跟踪功能时如何显示跟踪消息。这个属性的设置可以是SortByTime 或SortByCategory，默认设置是SortByTime Transaction 指定页面上是否支持事务处理。这个属性的设置可以是NotSupported、Supported、Required和RequiresNew，默认设置是NotSupported UICulture UICulture 属性的值指定ASP.NET 页面使用什么UI Culture。 ASP.NET 2.0允许给UICulture属性使用Auto值，支持自动检测UICulture ValidateRequest 设置为True时，根据一组潜在危险的值检查窗体输入值，帮助防止Web应用程序受到有害的攻击，例如JavaScript攻击。默认值是True WarningLevel 指定停止编译页面时的编译警告级别，其值可以是0到4 下面是使用Page指令的一个示例：Master指令 指定母版页Master指令非常类似于Page指令，但Master指令用于master页面(.master)。在使用Master指令时，要指定和站点上的内容页面一起使用的模板页面的属性。内容页面(使用Page指令建立)可以继承master页面上的所有master内容(在master页面上使用Master指令定义的内容)。尽管这两个指令是类似的，但Master指令的属性比Page指令少。Master指令的可用属性如表3-5所示。表 3-5属 性说 明 AutoEventWireUp 设置为True时，指定master页面的事件是否自动触发。默认设置为True ClassName 指定编译页面时绑定到master页面上的类名 CodeFile 引用与页面相关的后台编码文件 (续表) 属 性 说 明 CompilerOptions 编译字符串，表示master页面的编译选项 CompileWith 带一个String值，指向用于master页面的后台编码文件 Debug 设置为True时，用调试符号编译master页面 Description 提供master页面的文本描述。ASP.NET 解析器会忽略这个属性及其值 EnableTheming 设置为True时，表示master页面可以使用主题功能。其默认设置是False EnableViewState 设置为True时，维护master页面的视图状态。其默认设置是True Explicit 设置为True时，表示激活Visual Basic Explicit 选项。其默认设置是False Inherits 指定master页面要继承的CodeBehind类 Language 定义内置显示和脚本块使用的语言 LinePragmas Boolean值，指定得到的程序集是否使用行附注 MasterPageFile 带一个String值，指向master 页面所使用的master页面的地址。master页面可以使用另一个master页面，创建嵌套的master页面 Src 指向类的源文件，用于要显示的master页面的后台编码 Strict 设置为True时，使用Visual Basic Strict模式编译master页面。其默认设置是False WarningLevel 指定停止编译页面时的编译警告级别，其值可以是0到4 下面是使用Master指令的一个例子：Control指令 用户控件Control指令类似于Page指令，但Control指令是在建立ASP.NET用户控件时使用的。Control指令允许定义用户控件要继承的属性。这些属性值会在解析和编译页面时赋予用户控件。Control指令的可用属性比Page指令少，但其中有许多都可以在建立用户控件时进行需要的修改。表3-6详细介绍了这些可用属性。表 3-6属 性说 明 AutoEventWireUp 设置为True时，指定用户控件的事件是否自动触发。默认设置为True ClassName 指定编译页面时绑定到用户控件上的类名 CodeFile 引用与用户控件相关的后台编码文件 CompilerOptions 编译字符串，表示用户控件的编译选项 CompileWith 带一个String值，指向用于用户控件的后台编码文件 Debug 设置为True时，用调试符号编译用户控件 (续表) 属 性 说 明 Description 提供用户控件的文本描述。ASP.NET 解析器会忽略这个属性及其值 EnableTheming 设置为True时，表示用户控件可以使用主题功能。其默认设置是False EnableViewState 设置为True时，维护用户控件的视图状态。其默认设置是True Explicit 设置为True时，表示激活Visual Basic Explicit 选项。其默认设置是False Inherits 指定用户控件要继承的CodeBehind类 Language 定义内置显示和脚本块使用的语言 LinePragmas Boolean值，指定得到的程序集是否使用行附注 Src 指向类的源文件，用于要显示的用户控件的后台编码 Strict 设置为True时，使用Visual Basic Strict模式编译用户控件。其默认设置是False WarningLevel 指定停止编译页面时的编译警告级别，其值可以是0到4 Control指令用于ASP.NET用户控件。下面是使用该指令的一个例子：Import指令 导入指定命名空间namespace 要导入页的命名空间的名称。这可以包括任何包含在 .NET Framework 中的命名空间或自定义命名空间。 Implements指令 实现指定接口interface 要在页或用户控件中实现的接口。 Register指令 给命名空间和类名关联上别名，作为定制服务器控件语法中的记号tagprefix 与命名空间关联的别名。 tagname 与类关联的别名。 Namespace 与 tagprefix 关联的命名空间。 Src 与 tagprefix:tagname 对关联的声明性用户控件文件的位置（相对的或绝对的）。 Assembly 与 tagprefix 关联的命名空间所驻留的程序集。 注意 程序集名称不包括文件扩展名。Assembly指令 把程序集链接到与他相关的页面或用户控件上Name 表示要链接到页的程序集名称的字符串。 注意 程序集名称不包括文件扩展名。Src 要动态编译和链接的源文件的路径。 注意 不能在同一个 Assembly 指令中包含 Name 和 Src 属性。如果您要使用这两个属性，页上必须包含多个指令。MasterType指令 把类名与页面关联，获得包含在特定master页面中的强类型化的引用或者成员 MasterType指令把一个类名关联到ASP.NET页面上，以获得特定master页面中包含的强类型化引用或成员。这个指令支持两个属性： TypeName：设置从中获得强类型化的引用或成员的派生类名。 VirtualPath：设置从中检索这些强类型化的引用或成员的页面地址。使用MasterType指令的细节请参阅第8章。下面是它的一个例子：OutputCache指令 控制页面或用户控件输出的高速缓存策略Duration 页或用户控件进行缓存的时间（以秒计）。在页或用户控件上设置该属性为来自对象的 HTTP 响应建立了一个过期策略，并将自动缓存页或用户控件输出。 注意 该属性是必需的。如果未包含该属性，将出现分析器错误。Location OutputCacheLocation 枚举值之一。默认值为 Any。 警告 包含在用户控件（.ascx 文件）中的 OutputCache 指令不支持此属性。Shared 一个布尔值，确定用户控件输出是否可以由多个页共享。默认值为 false。有关详细信息，请参见备注部分。 注意 包含在 ASP.NET 页（.aspx 文件）中的 OutputCache 指令不支持此属性。VaryByCustom 表示自定义输出缓存要求的任意文本。如果赋予该属性的值是 browser，缓存将随浏览器名称和主要版本信息的不同而不同。如果输入了自定义字符串，您必须在应用程序的 Global.asax 文件中重写 HttpApplication.GetVaryByCustomString 方法。 VaryByHeader 分号分隔的 HTTP 标头列表，用于使输出缓存发生变化。当将该属性设为多标头时，对于每个指定的标头，输出缓存都包含一个请求文档的不同版本。 注意 设置 VaryByHeader 属性在所有 HTTP 1.1 缓存中启用缓存项，而不仅限于 ASP.NET 缓存。用户控件中的 OutputCache 指令不支持此属性。VaryByParam 分号分隔的字符串列表，用于使输出缓存发生变化。默认情况下，这些字符串与用 GET 方法属性发送的查询字符串值对应，或与用 POST 方法发送的参数对应。当将该属性设置为多参数时，对于每个指定的参数，输出缓存都包含一个请求文档的不同版本。可能的值包括 none、* 和任何有效的查询字符串或 POST 参数名称。 警告 在输出缓存 ASP.NET 页时，该属性是必需的。它对于用户控件也是必需的，除非已经在用户控件的 OutputCache 指令中包含了 VaryByControl 属性。如果没有包含它，则发生分析器错误。如果您不想使缓存内容随任何指定参数发生变化，请将该值设为 none。如果要使输出缓存根据所有参数值发生变化，请将属性设置为 *。VaryByControl 一个分号分隔的字符串列表，用于更改用户控件的输出缓存。这些字符串代表在用户控件中声明的 ASP.NET 服务器控件的 ID 属性值。注意 除非已经包含了 VaryByParam 属性，否则在用户控件 OutputCache 指令中，该属性是必需的。ASP.NET 页中的 OutputCache 指令不支持该属性。Ref