ASP.NET - 指令

ASP.NET 指令是用于指定可选设置的指令，例如注册自定义控件和页面语言。这些设置描述了 .Net 框架如何处理 Web 窗体 (.aspx) 或用户控件 (.ascx) 页面。

声明指令的语法为

<%@  directive_name attribute=value  [attribute=value]  %>

在本节中，我们将简单介绍 ASP.NET 指令，并在整个教程中使用大多数这些指令。

Application 指令

Application 指令定义特定于应用程序的属性。它位于 global.aspx 文件的顶部。

Application 指令的基本语法为

<%@ Application Language="C#" %>

Application 指令的属性为

Assembly 指令在解析时将程序集链接到页面或应用程序。这可以出现在 global.asax 文件中以进行应用程序范围的链接，也可以出现在页面文件、用户控件文件中以进行链接到页面或用户控件。

Assembly 指令的基本语法为

<%@ Assembly Name ="myassembly" %>

Assembly 指令的属性为

属性	描述
Name	要链接的程序集的名称。
Src	要链接并动态编译的源文件的路径。

Control 指令与用户控件一起使用，并出现在用户控件 (.ascx) 文件中。

Control 指令的基本语法为

<%@ Control Language="C#"  EnableViewState="false" %>

Control 指令的属性为

属性	描述
AutoEventWireup	启用或禁用将事件自动关联到处理程序的布尔值。
ClassName	控件的文件名。
Debug	启用或禁用使用调试符号进行编译的布尔值。
描述	控件页面的文本描述，编译器会忽略。
EnableViewState	指示是否在页面请求之间维护视图状态的布尔值。
Explicit	对于 VB 语言，告诉编译器使用 Option Explicit 模式。
Inherits	控件页面继承的类。
Language	代码和脚本的语言。
Src	代码隐藏类的文件名。
Strict	对于 VB 语言，告诉编译器使用 Option Strict 模式。

Implement 指令指示网页、母版页或用户控件页面必须实现指定的 .Net 框架接口。

Implements 指令的基本语法为

<%@ Implements  Interface="interface_name" %>

Import 指令将命名空间导入到网页、用户控件页面或应用程序中。如果在 global.asax 文件中指定了 Import 指令，则它将应用于整个应用程序。如果它位于页面或用户控件页面中，则它将应用于该页面或控件。

Import 指令的基本语法为

<%@ namespace="System.Drawing" %>

Master 指令将页面文件指定为母版页。

示例 MasterPage 指令的基本语法为

<%@ MasterPage Language="C#"  AutoEventWireup="true"  CodeFile="SiteMater.master.cs" Inherits="SiteMaster"  %>

MasterType 指令将类名分配给页面的 Master 属性，使其成为强类型。

MasterType 指令的基本语法为

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

OutputCache 指令控制网页或用户控件的输出缓存策略。

OutputCache 指令的基本语法为

<%@ OutputCache Duration="15" VaryByParam="None"  %>

Page 指令定义特定于页面文件的属性，供页面解析器和编译器使用。

Page 指令的基本语法为

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

Page 指令的属性为

属性	描述
AutoEventWireup	启用或禁用自动绑定到方法的页面事件的布尔值；例如，Page_Load。
Buffer	启用或禁用 HTTP 响应缓冲的布尔值。
ClassName	页面的类名。
ClientTarget	服务器控件应为其呈现内容的浏览器。
CodeFile	代码隐藏文件的文件名。
Debug	启用或禁用使用调试符号进行编译的布尔值。
描述	页面的文本描述，解析器会忽略。
EnableSessionState	启用、禁用或使会话状态只读。
EnableViewState	启用或禁用页面请求之间视图状态的布尔值。
ErrorPage	如果发生未处理的页面异常，则重定向的 URL。
Inherits	代码隐藏或其他类的名称。
Language	代码的编程语言。
Src	代码隐藏类的文件名。
Trace	启用或禁用跟踪。
TraceMode	指示如何显示跟踪消息，以及按时间或类别排序。
Transaction	指示是否支持事务。
ValidateRequest	指示是否根据硬编码值列表验证所有输入数据的布尔值。

PreviousPageType 指令将类分配给页面，以便页面成为强类型。

示例 PreviousPagetype 指令的基本语法为

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

Reference 指令指示应编译另一个页面或用户控件并链接到当前页面。

Reference 指令的基本语法为

<%@ Reference Page ="somepage.aspx" %>

<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>

打印页面