服务器端包含
你可以在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
相对于某个虚拟目录的全路径。