九、 包含文件.pdfVIP

九、 包含文件 SSI 指令为用户提供在 Web 服务器处理之前将一个文件的内容插入 另一个文件的方法。ASP 只使用这一机制的 #include 指令。要在 .asp 文件中 插入一个文件，使用下面的语法： !--#include virtual | file =filename-- virtual 和 file 关键字指示用来包含该文件的路径的类型，filename 是您想 包含的文件的路径和名称。 被包含文件不要求专门的文件扩展名；但是，为被包含文件赋予 .inc 扩展名以 便和其他类型文件相区分是一个良好的编程习惯。 使用 Virtual 关键字 使用 Virtual 关键字指出路径开始于虚拟目录。例如，如果一个被命名为 Footer.inc 的文件属于一个名为 /Myapp 的虚拟目录，则下面的一行将把 Footer.inc 的内容插入到包含该行的文件中： !--#include virtual =/myapp/footer.inc-- 使用 File 关键字 使用 file 关键字指示使用相对路径。相对路径开始于含有该包含文件的目录。 例如，如果您的文件位于目录 Myapp 中，而文件 Header1.inc 在 Myapp\Headers 中，下面的一行将把 Header1.inc 插入到您的文件中： !--#include file =headers/header1.inc-- 注意，到被包含文件 Headers/header1.inc 的路径是相对于包含文件的；如果 包含 #include 语句的脚本不在 /Myapp 目录中，那么该语句将不起作用。 如果在 Internet 服务管理器中的“启用上层目录”选项被选中，则也可以使用 file 关键字和 ../ 语法包含父目录即上一层目录中的文件。有关命令，请参阅 配置 ASP 应用程序。 被包含文件的位置 被包含文件可以在您的 Web 站点内的某个目录中，也可以在您的 Web 站点之 外。通常，您应该使被包含文件位于 Web 站点的目录中。如果一个被包含文件 位于您的 Web 站点内，则当浏览器下次请求包含文件时，将显示对被包含文件 的改变。但是，如果被包含文件位于您的 Web 站点之外，直到 ASP 应用程序重 新启动或 Web 服务器重新启动时，这种改变才能体现出来。ASP 检测在应用程 序命名空间中（在应用程序的起始目录下）的任何包含文件的改变。 包含文件：提示和警告 一个被包含文件也可以包含其他的文件。如果 #include 指令没有导致循环，一 个 .asp 文件可以多次包括同一个文件。例如，如果文件 First.asp 包含文件 Second.inc，则 Second.inc 一定不能再包含 First.asp。一个文件也不能包含 自身。ASP 检测此类循环或嵌套错误，并在检测到时产生一个错误消息，同时停 止处理被请求的 .asp 文件。 ASP 在执行脚本命令之前包含文件。因此，不能用脚本命令去创建被包含文件的 名称。例如，下面的脚本将不能打开 Header1.inc，因为 ASP 会在它分配一个 文件名给变量 name 之前先执行 #include 指令。 !-- This script will fail -- % name=(header1 .inc) % !--#include file=%= name %-- 脚本命令和过程必须完全包含在脚本定界符 % 和 % 、HTML 标记 SCRIPT 和 /SCRIPT 或 HTML 标记 OBJECT 和 /OBJECT 中。也就是说，不能在一 个 .asp 包含文件中打开一个脚本定界符，然后在一个被包含的文件中才关闭该 定界符；脚本或脚本命令必须是一个完整的单元。例如，下面的脚本将无法运行： !-- This script will fail -- % For i = 1 To n statements in main file !--#include file=header1.inc -- Next % 下面的脚本将正常运行： % For i = 1 to n statements in main file % !--#include file