#config ディレクティブは、SSI エラー メッセージに使用される文字列および #flastmod や #fsize によって返される日付とファイル サイズに使用される形式を指定します。ディレクティブは、HTML のコメント デリミタで囲む必要があります。
既定値では、このディレクティブは STM ページでのみ使用できます。ASP ページでは使用できません。このタスクを ASP スクリプトで実行するには、FileSystemObject オブジェクトを使用します。これについては、MSDN の VBScript または JScript の項に記載されています。
<!-- #config Output = String -->
Output
書式設定する出力を指定します。出力は、次のいずれか 1 つを指定できます。
出力 | 意味 |
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 10 進数で表した 1 か月の中の日 (01 〜 31)。 %H 24 時間形式の時間 (00 〜 23)。 %I 12 時間形式の時間 (01 〜 12)。 %j 10 進数で表した 1 年の中の日 (001 〜 366)。 %m 10 進数で表した月 (01 〜 12)。 %M 10 進数で表した分 (00 〜 59)。 %p 12 時間形式の場合、現在の C ロケールで午前/午後を表す記号 (PM など)。 %S 10 進数で表した秒 (00 〜 59)。 %U 10 進数で表した 1 年の中の週。日曜日を週の最初の日とします (00 〜 51)。 %w 10 進数で表した曜日。日曜日を週の最初の日とします(0 〜 6)。 %W 10 進数で表した 1 年の中の週。月曜日を週の最初の日とします (00 〜 51)。 %x C ロケールに従った日付表示 (05/06/01 など)。 %X C ロケールに従った時刻表示 (12:51:32 など)。 %y 10 進数で表した西暦の下 2 桁 (01 など)。 %Y 10 進数で表した 4 桁の西暦 (2001 など)。 %z, %Z タイムゾーン名またはその省略形。タイムゾーンが不明な場合は文字が入りません。 %% パーセント記号。 |
SIZEFMT | #fsize ディレクティブの出力を、ファイル サイズをキロバイト単位またはバイト単位で表示するよう構成します。String パラメータには、2 つの値のいずれかを指定できます。"ABBREV" を指定すると、ファイル サイズはキロバイト単位で表示されます。"BYTES" を指定すると、ファイル サイズはバイト単位で表示されます。 |
重要
このディレクティブが入ったファイルには、SSI インタプリタにマップされるファイル名拡張子を使う必要があります。拡張子が異なると、Web サーバーはディレクティブを処理しません。既定では、ファイル名拡張子 .stm、.shtm、および .shtml が SSI インタプリタ (ssinc.dll) にマップされます。#echo ディレクティブを使用する STM ページは、それ自身または ASP ページから Response.Redirect を使用して実行する必要があります。STM ページを ASP ページから Server.Transfer、Server.Execute、または #include を使用して呼び出すと、STM ページが ssinc.dll ではなく asp.dll を通過するよう強制されるため、機能しません。
IIS スナップインをインストールしている場合、既定の拡張子マッピングを変更して新しいマッピングを追加できます。 詳細については、「アプリケーションのマッピングを設定する」を参照してください。 ファイル拡張子を複数の実行可能ファイルにマップすることはできないため、このディレクティブを 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" -->