服务器端包括指令语法

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

将指定文件的内容插入 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

其他资源

ASP.NET User Controls