#config 指令指定用于 SSI 错误信息的字符串,及由 #flastmod 和 #fsize 返回的日期和文件大小所使用的格式。必须使用 HTML 注释分隔符将指令括起来。
默认情况下,此指令仅可用于 STM 网页,无法用于 ASP 网页。若要用 ASP 脚本执行同样的任务,可以使用 FileSystemObject 对象,可以在 MSDN 中(在 VBScript 或 JScript 下)找到有关此对象的说明。
<!-- #config Output = String -->
Output
指定要被格式化的输出,输出可以是下列形式之一:
| 输出 | 含义 |
| ERRMSG | 当 SSI 指令处理过程中出现错误时将覆盖返回给客户端浏览器的消息。默认情况下,错误信息将提供详细描述出错情况的调试信息。如果取消显示这些详细情况,将提供短小、简单的错误信息,例如“出现 SSI 错误”。String 参数包含新的错误信息。 |
| TIMEFMT | 指定发出 #flastmod 指令时,返回客户端浏览器的日期格式。String 参数指定格式。可用 String 中的格式符号抽取日期中的个别部分,例如星期几或者几号。(格式符号与用于 ANSI C strftime 函数的符号相同)。 注意 下列时间和日期函数使用 C 库区域设置(而不是操作系统区域设置)设定的语言。C 库区域设置通常设为英语。 %a “一周内的第几天”的缩写(例如,Mon)。 %A “一周内的第几天”的完整名称(例如,Monday)。 %b 月份的缩写(例如,Feb)。 %B 完整的月份名称(例如,February)。 %c 对应于 C 区域设置的日期和时间表示方法(例如,05/06/01 12:51:32)。 %d 十进制数表示的“一个月中的第几天” (01-31)。 %H 24 小时格式表示的小时 (00-23)。 %I 12 小时格式表示的小时 (01-12)。 %j 十进制数表示的“一年中的第几天”(001-366)。 %m 十进制数表示的月份 (01-12)。 %M 十进制数表示的分钟 (00-59)。 %p 与 12 小时格式对应的当前 C 区域设置的 A.M. 或 P.M. 标识符(例如,PM)。 %S 十进制数表示的秒 (00-59)。 %U 十进制数表示的“一年中的第几个星期”,以星期天作为每星期的第一天 (00-51)。 %w 十进制数表示的“一周内的第几天”,以星期天作为第一天 (0-6)。 %W 十进制数表示的“一年中的第几个星期”,以星期一作为每星期的第一天 (00-51)。 %x 当前 C 区域设置的日期表示方法(例如,05/06/01)。 %X 当前 C 区域设置的时间表示方法(例如,12:51:32)。 %y 十进制数表示的两位年份(例如,01)。 %Y 十进制数表示的四位年份(例如,2001)。 %z, %Z 时区名或缩写;如果时区未知,则没有字符。 %% 百分比符号。 |
| SIZEFMT | 对 #fsize 指令的输出进行配置,以 KB 或字节为单位显示文件大小。String 参数可以为下列两个值之一:“ABBREV”以 KB 为单位显示文件大小,“BYTES”以字节为单位显示文件大小。 |
要点
包含此指令的文件必须使用已映射到 SSI 解释程序的扩展名。否则,Web 服务器将不处理此指令。默认情况下,文件扩展名 .stm、.shtm 和 .shtml 将映射到 SSI 解释程序 (ssinc.dll)。使用 #echo 指令的 STM 网页既可以自运行,也可以通过 Response.Redirect 从 ASP 网页调用它来运行。用 Server.Transfer、Server.Execute 或 #include 从 ASP 网页中调用 STM 网页是行不通的,因为这样会迫使 STM 网页通过 asp.dll 而不是通过 ssinc.dll 进行解释。
如果安装了 Internet 信息服务管理单元,则可以修改默认扩展名映射并添加新映射,请参阅设置应用程序映射。 由于不能将一个文件扩展名映射到多个可执行文件,所以不能在 ASP 文件中使用此指令。ASP 文件已映射到 asp.dll,并且必须保持此状态。
--- SSI.stm ---
<!-- #config ERRMSG = "An error occurred processing a directive." -->
SSI.stm was last formatted on <!-- #config TIMEFMT = "%A, the %d of %B, %Y, at %H:%M" --> <!-- #flastmod FILE = "ssi.stm" --> <BR> The size of SSI.stm in bytes is <!-- #config SIZEFMT = "BYTES" --> <!-- #fsize FILE = "ssi.stm" --> <BR><BR> This line will print out the ERRMSG configured above<BR> <!-- #config SIZEFMT = "BYTE" -->