服务器端包括指令语法
[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
将指定文件的内容插入 ASP.NET 文件中,包括网页(.aspx 文件)、用户控件文件(.ascx 文件)和 Global.asax 文件。
<!-- #include file|virtual="filename" -->
特性
File
文件名是相对于包含带有 #include 指令的文件的目录的物理路径。 此路径可以是相对的。备注
包括的文件可以位于同一目录或子目录中;但该文件不能位于带有 #include 指令的文件的上级目录中。
Virtual
文件名是网站中虚拟目录的虚拟路径。 此路径可以是相对的。备注
由于文件的物理路径可能会更改,因此建议采用此方法。
备注
赋予 File 或 Virtual 特性的值必须用引号 ("") 括起来。 在执行任何动态代码之前处理被包含的文件。 从静态文本(如公共页标题或公司地址)到公共服务器端代码、控件或开发人员要插入到其他页中的 HTML 标记块,包含文件可用于包含任何内容。
备注
尽管您仍然可以使用 #include 标记(通过将公共服务器端代码、控件或 HTML 标记放入要包括在其他网页中的文件内)以实现代码重用,ASP.NET 常用的首选方法是使用 Web 用户控件。用户控件提供了一个面向对象的编程模型,并且提供了比服务器端包含文件更多的功能。有关详细信息,请参见ASP.NET User Controls。
#include 标记必须包括在 HTML 或 XML 注释分隔符内以避免被解释为文本。
示例
下面的代码示例演示如何使用服务器端包含指令语法来调用将在 ASP.NET 页上创建页眉和脚注的文件。 两个文件都使用相对路径。
<html>
<body>
<!-- #Include virtual="/include/header.inc" -->
Here is the main body of the .aspx file.
<!-- #Include virtual="/include/footer.inc" -->
</body>
</html>
请参见
概念
ASP.NET Web Page Syntax Overview