#include ディレクティブは、ファイルの内容を Web ページに挿入するよう、Web サーバーに命令します。ディレクティブは、HTML のコメント デリミタで囲む必要があります。
このディレクティブは ASP ページ、STM ページ、INC ページ、または SSI インタプリタ (ssinc.dll) または ASP インタプリタ (asp.dll) にマップされるファイル名拡張子を持つ任意のページで使用できます。インターネット サービス マネージャをインストールしている場合、既定の拡張子マッピングを変更して新しいマッピングを追加できます。詳細については、「アプリケーションのマッピングを設定する」を参照してください。
インクルードされるファイルのファイル名拡張子は特に決まっていませんが、拡張子 .inc を付けることをお勧めします。インクルードされるファイルは呼び出しページのインタプリタで処理されます。たとえば、#exec ディレクティブを使用するページをインクルードする場合は、STM ページから呼び出す必要があり、ASP スクリプトを使用しているページをインクルードする場合は、ASP ページから呼び出す必要があります。このようにすると、インクルードされる HTM ページは期待通りに動作します。
<!-- #include PathType = FileName -->
PathType
FileName へのパスの種類を指定します。パスの種類は、次のいずれか 1 つを指定できます。
パスの種類 | 意味 |
File | FileName は、#finclude ディレクティブが入ったドキュメントがあるディレクトリからの相対パスです。インクルードされるファイルは、同じディレクトリまたはサブディレクトリに入れることができます。インクルードされるファイルは、Web フォルダのプロパティ シートの [親のパスを有効にする] チェック ボックスをオンにしていない限り、 #include ディレクティブを使用したページより上のディレクトリに入れることはできません。チェック ボックスをオンにすることは、セキュリティ上のリスクがあるため勧められていません。Web ユーザーがサイトの URL の一部として「../..」を入力すると、ユーザーに参照させたくない親フォルダの内容を表示することができます。 |
仮想 | ファイル名は、Web サイトの仮想ディレクトリからの完全な仮想パスです。 |
FileName
インクルードするファイルの名前を指定します。FileName には、ファイル名拡張子を含める必要があります。また、ファイル名は、二重引用符 (") で囲む必要があります。
重要
このディレクティブが入ったファイルには、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 にマップされていて、そのまま保持する必要があります。
--- IncExample.asp ---
<!-- The included file is in the same directory as IncExample.asp. --> <!-- #include file = "myfile.inc" --> <!-- The included file is in the directory above IncExample.asp. Enable Parent Paths must be checked for the web folder. --> <!-- #include file = "..\myfile.htm" --> <!-- The included file is in the Scripts virtual directory. --> <!-- #include virtual = "/scripts/tools/global.inc" -->