服务器端包含

你可以在Internet Information Server(IIS)内使用下面所述的所有服务器端包含。然而只有指示#INCLUDE能在Active Serve Page使用。为了使用其它的任一指示，你必须使用如.stm，.shtm，或.shtml文件扩展名。

除了#INCLUDE指示以外，IIS服务器端包含现在不再非常有用。相同的功能可以通过使用Active Serve Page更灵活地实现。这里对服务器端包含的介绍主要是考虑到完整性问题。

#CONFIG

<!-- #CONFIG OUTPUT=

”string” -->

指明如何来格式化错误信息，日期，或文件长度。OUTPUT可以是下面的任一参数。

- ERRMSG

指明当在处理服务器端包含时，如果发生错误要显示的错误信息。string就是要显示的错误信息。

- TIMEFMT

指明日期和时间的格式化形式。你可以使用下表所示的格式符号。

符号 | 描述
%a | 一周中某天的缩写（例如，Mon）。
%A | 一周中某天的全称（例如，Monday）。
%b | 月份的缩写（例如，Feb）。
%B | 月份的全称（例如，February）。
%c | 当地的日期和时间的表示（例如，05/06/91 12:51:32）。
%d | 以十进制数字表示的一个月中的某天 (01-31)。
%H | 24 小时格式 (00-23)。
%I | 12 小时格式 (01-12)。
%j | 以十进制数字表示一年中的某天 (001-366
%m | 以十进制数字表示的月份 (01-12)。
%M | 以十进制数字表示的分 (00-59)。
%p | 当地的上午或下午指示符（例如，PM）。
%S | 以十进制数字表示的秒 (00-59)。
%U | 以十进制数字表示一年中的某一周，星期日作为一周的开始 (00-51)。
%w | 以十进制数字表示一周中的某一天，星期天是第一天 (0-6)。
%W | 以十进制数字表示一年中的某一天，星期一作为一周的开始 (00-51)。
%x | 当地的日期表示（例如，05/06/91）。
%X | 当地的时间表示（例如，12:51:32）。
%y | 以十进制数字表示的不带有世纪的年（例如，69）。
%Y | 以十进制数字表示的带有世纪的年（例如，1969）。
%z或%Z | 时区全称或缩写；如果不知道时区，则没有字符。
%% | 百分号。

- SIZEFMT

如果该字符串是”ABBREV”，将以1K字节为单位显示文件大小。如果该字符串是”BYTE”，将以字节为单位显示文件大小。

#ECHO

<!-- #ECHO var=

”Variable Name” -- >

显示某个环境变量的值(HTTP头)。对于Variable Name你可以使用下表内的任意一个变量。

变量 | 描述
ALL_HTTP | 显示所有那些还没有被解析为此表中的其他变量的 HTTP 标题。
AUTH_TYPE | 用于验证用户的身份验证类型。
AUTH_PASSWORD | 在客户端身份验证对话框中输入的密码。该变量只有在使用基本身份验证时才有效。
AUTH_USER | 在客户端身份验证对话框中输入的用户名。该变量只有在使用基本身份验证时才有效。
CONTENT_LENGTH | 从客户端收到的字节数。
CONTENT_TYPE | 发送的表单内容或HTTP PUT的内容类型。
DOCUMENT_NAME | 当前文件名称。
DOCUMENT_URI | 当前文档的虚拟路径。
DATE_GMT | 以格林威治时间表示的当前日期 (GMT)。
DATE_LOCAL | 以当地时区为标准的当前日期。
GATEWAY_INTERFACE | Web服务器所使用的 CGI 规范的修正版。
HTTP_ACCEPT | 以逗号隔开的MIME类型列表。
LAST_MODIFIED | 当前文档的最终修改日期。
PATH_INFO | 客户端给出附加路径信息。此信息由在脚本名称后，查询字符串（如果有的话）前的 URL 后缀部分构成。
PATH_TRANSLATED | PATH_INFO 的值，但带有扩展为某个目录规范的虚拟路径。
QUERY_STRING | 在引用该脚本的 URL 中跟在问号 (?) 后面的信息。
QUERY_STRING_UNESCAPED | 查询字符串的未转义版本；即非 URL 编码的版本。
REMOTE_ADDR | 发出请求的客户或客户代理（比如，网关或防火墙）的 IP 地址。
REMOTE_HOST | 发出请求的客户或客户代理（比如，网关或防火墙）的主机名。
REMOTE_USER | 它包含由客户端提供并由服务器验证的用户名。如果用户是匿名用户（但已经验证），则返回空字符串。
REQUEST_METHOD | HTTP 请求方法。
SCRIPT_NAME | 正被执行的脚本程序的名称。
SERVER_NAME | 服务器的主机名或 IP 地址。
SERVER_PORT | 接收请求的 TCP/IP 端口。
SERVER_PORT_SECURE | 字符串 "0" 或 "1"。如果请求在安全端口被处理，为"1"，否则为 "0"。
SERVER_PROTOCOL | 与请求有关的信息检索协议的名称与版本，通常为 HTTP/1.0。协议以 name/version 的格式返回。
SERVER_SOFTWARE | 响应请求的 Web 服务器的名称和版本。服务器信息以 name/version 的格式返回。
URL | 给出 URL 的基本部分，不包含参数值。参数值在 Web 服务器从标题信息中解析 URL 时确定。

#EXEC

<! -- #EXEC CommandType=

”Command Description” -- >

执行一个应用程序，脚本，或shell 命令。对于CommandType你可以使用下表所示的两种变量类型。

命令类型 | 描述
CGI | 运行一个应用程序，如 CGI 脚本、ASP 或 ISAPI 应用程序。CommandDescription 参数是一个字符串。此字符串包含应用程序的虚拟路径，后跟一个问号以及传送给应用程序的任一参数，参数之间由加号分隔 (+)。
CMD | 运行 shell 命令。 CommandDescription 参数是一个字符串，其中包含 shell 命令程序的完整物理路径，后跟由空格分隔的任何命令行参数。如果没有指定全路经， Web 服务器将搜索系统路径。默认情况下，该指令是被禁用的，这是因为它会对 Web 站点造成安全方面的危险；例如，用户可能使用 format 命令格式化您的硬盘。要启用该指令，可在注册表中加入 SSIEnableCmdDirective 项并将其值设为 TRUE。

#FLASTMOD

< ! -- #FLASTMOD PathType=

”FileName” -- >

返回指定的文件最近一次被修改的时间。对于PathType，你可以指定为下表所示的两个路径类型之一。

路径类型 | 描述
FILE | 相对于当前文档所在目录的路径。
VIRTUAL | 相对于某个虚拟目录的全路径。

#FSIZE

< ! -- #FSIZE PathType=

”FileName” -- >

返回文件的长度。对于PathType，你可以指定为下表所示的两个路径类型之一。

路径类型 | 描述
FILE | 相对于当前文档所在目录的路径。
VIRTUAL | 相对于某个虚拟目录的全路径。

#INCLUDE

<! -- #INCLUDE PathType=

”FileName” -- >

在当前文档内包含其它文件。对于PathType，你可以指定为下表所示的两个路径类型之一。

路径类型 | 描述
FILE | 相对于当前文档所在目录的路径。
VIRTUAL | 相对于某个虚拟目录的全路径。