服务器端包含
你可以在Internet Information Server(IIS)内使用下面所述的所有服务器端包含。然而只有指示#INCLUDE能在Active Serve Page使用。为了使用其它的任一指示,你必须使用如.stm,.shtm,或.shtml文件扩展名。
除了#INCLUDE指示以外,IIS服务器端包含现在不再非常有用。相同的功能可以通过使用Active Serve Page更灵活地实现。这里对服务器端包含的介绍主要是考虑到完整性问题。
#CONFIG
<!-- #CONFIG OUTPUT=
”string” -->指明如何来格式化错误信息,日期,或文件长度。OUTPUT可以是下面的任一参数。
指明当在处理服务器端包含时,如果发生错误要显示的错误信息。string就是要显示的错误信息。
指明日期和时间的格式化形式。你可以使用下表所示的格式符号。
符号 |
描述 |
%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 |
时区全称或缩写;如果不知道时区,则没有字符。 |
%% |
百分号。 |
如果该字符串是”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 |
相对于某个虚拟目录的全路径。 |