服务器端包括指令语法

  • 项目

将指定文件的内容插入 ASP.NET 文件中，包括网页（.aspx 文件）、用户控件文件（.ascx 文件）和 Global.asax 文件。

<!-- #include file|virtual="filename" -->

特性

  • File
    文件名是相对于包含带有 #include 指令的文件的目录的物理路径。 此路径可以是相对的。

    注意注意

    包括的文件可以位于同一目录或子目录中；但该文件不能位于带有 #include 指令的文件的上级目录中。

  • Virtual
    文件名是网站中虚拟目录的虚拟路径。 此路径可以是相对的。

    注意注意

    由于文件的物理路径可能会更改，因此建议采用此方法。

备注

赋予 File 或 Virtual 特性的值必须用引号 ("") 括起来。 在执行任何动态代码之前处理被包含的文件。 从静态文本（如公共页标题或公司地址）到公共服务器端代码、控件或开发人员要插入到其他页中的 HTML 标记块，包含文件可用于包含任何内容。

注意注意

尽管您仍然可以使用 #include 标记（通过将公共服务器端代码、控件或 HTML 标记放入要包括在其他网页中的文件内）以实现代码重用，ASP.NET 常用的首选方法是使用 Web 用户控件。用户控件提供了一个面向对象的编程模型，并且提供了比服务器端包含文件更多的功能。有关详细信息，请参见 ASP.NET 用户控件。

#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 网页语法概述

其他资源

ASP.NET 用户控件