中国最全IT社区平台联系我们 | 收藏本站

aspnet教程

ASP.NET 教程

ASP.NET 简介

ASP.NET Razor

ASP.NET MVC

ASP.NET 编程指南

←上一篇： ASP.NET 多视图

→下一篇：ASP.NET Panel 控件

ASP.NET 指令

阅读 (2314)

指令

ASP.NET 指令是指定可选设置的说明，如注册一个自定义的控制和页面的语言。这些设置介绍了 NET Framework 如何处理单页表单(.aspx)或用户控件(.ascx)网页。

下达指令的基本语法：

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

在这一部分中，我们将介绍 ASP.NET 指令，同时会在整个教程中应用大多数指令。

应用程序指令

应用指令定义特定应用程序的属性。它是在 global.aspx 文件的顶部提供。

应用程序指令的基本语法：

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

应用程序指令的属性：

属性	描述
Inherits	从类的名称中继承。
Description	应用的文本描述。解析器和编译器忽略这一点。
Language	应用在代码组中的语言。

集合指令

集合指令链接着一个网页链接的组件或在分析时的应用程序。这可能会出现在整个应用类型链接 Global.asax 文件中，页面文件中，用于链接到另一个网页的用户控件中或用户控件中。

集合控件的基本语法是：

<%@ Assembly Name ="myassembly" %>

集合控件的属性是：

属性	描述
Name	被链接的集合组件的名称。
Src	源文件被动态链接和编辑的路径。

控制指令

控制指令是与用户控件一同使用并出现在用户控件(.ascx)文件中。

控制指令的基本语法是：

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

控制指令的属性是：

属性	描述
AutoEventWireup	允许或禁用事件处理程序的自动关联的布尔值。
ClassName	控件的文件名。
Debug	许或禁用编辑调试符号的布尔值。
Description	控制页面的文字说明，被编译器忽略。
EnableViewState	页面请求为是否保持视图状态的布尔值。
Explicit	在 VB 语言下，告知编辑器使用选项显示模式。
Inherits	控制页面继承的类。
Language	编码和脚本的语言。
Src	代码隐藏类的文件名。
Strict	在 VB 语言下，告知编辑器使用选项标准模式。

工具指令

工具指令表明网页，母版页或者用户控制页必须执行具有详细说明的.Net 框架界面。

工具指令的基本语法是：

<%@ Implements  Interface="interface_name" %>

导入指令

导入指令导入一个命名空间到用户控制应用程序的页面。如果在 global.asax 文件中指定了 Import 指令，那么会将其应用到整个应用程序。如果它是在用户控制页面的网页中，则会将其应用到该网页或控件中。

导入指令的基本语法是：

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

主要指令

主要指令指定了一个页面文件作为主页。

样本主页指令的基本语法是：

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

MasterType 指令

MasterType 指令指定一个类名到页面的主属性，强化其类型。

母版式指令的基本语法是：

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

输出缓存指令

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

输出缓存指令的基本语法：

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

页面指令

页面指令定义特定的页面分析器和编译器的页面文件的属性。

页面指令的基本语法是：

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

页面指令的属性是：

属性	描述
AutoEventWireup	允许或禁用正在自动绑定到方法页面事件的布尔值;例如，Page_Load。
Buffer	允许或禁用 HTTP 响应缓冲的布尔值。
ClassName	页面的类别名称。
ClientTarget	服务器控件应呈现的内容的浏览器
CodeFile	代码隐藏文件的名称。
Debug	允许或禁止使用调试符号编译的布尔值。
Description	页面的文件说明，由解析器忽略。
EnableSessionState	启用或禁用页面会话状态为只读。
EnableViewState	允许或禁止跨页请求视图状态的布尔值。
ErrorPage	未经处理的页面异常发生的情况下的重定地址。
Inherits	后台代码或其他类的名称。
Language	代码的编程语言。
Src	后台代码类的文件名。
Trace	启用或禁用跟踪。
TraceMode	表示跟踪信息的显示方式，并按照时间或者类别排序。
Transaction	表示交易是否被支持。
ValidateRequest	表示所有输入数据是否被有效验证为 hardcoded 列表值得布尔值。

前页型指令

前页型指令为一个页面分配类别，使得该页面类型被强化。

前页型指令的样本的基本语法：

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

参考指令

参考指令表明另一个页面或用户控件应编译和链接到当前页面。

参考指令的基本语法是：

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

注册指令

注册指令用于注册定制服务器控件和用户控件。

注册指令的基本语法是：

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