Execute

(IIS5)
Execute — .asp ファイルを実行します。

Server.Execute ( Path )

パラメータ
Path 実行する .asp ファイルの場所を指定する文字列です。
このパラメータに絶対パスを指定する場合は、このパスは同じアプリケーションの範囲内にある .asp ファイルへのパスでなければなりません。

説明

Execute メソッドは、.asp ファイルを呼び出し、ASP スクリプトの呼び出しの一部であるかのように処理します。Execute メソッドは、多くのプログラミング言語にあるプロシージャ コールに似ています。

Server.Execute メソッドは、複雑なアプリケーションを個別のモジュールに分割する方法を提供します。Server.Execute メソッドを使用すると、必要に応じて呼び出すことができる .asp ファイルのライブラリを作成できます。この方法は、サーバー側インクルードに代わるものです。
Server.Execute の入力パラメータで指定した .asp ファイルが IIS によって処理されると、呼び出し元の ASP スクリプトに応答が返されます。実行された .asp ファイルは HTTP ヘッダーを変更することができます。ただし、ほかの .asp ファイルと同じように、実行された .asp ファイルが、クライアントへの応答が送られた後で HTTP ヘッダーを変更しようとすると、エラーが発生します。
パス パラメータには、絶対パスと相対パスのいずれかを指定できます。絶対パスの場合は、呼び出し元の .asp ファイルと同じアプリケーションの ASP スクリプトにマップする必要があります。
パス パラメータには、クエリ文字列を含めることができます。
呼び出し元または呼び出し先の .asp ファイルのいずれかに、トランザクションディレクティブが含まれている場合、トランザクションの状態はディレクティブを含む方の .asp ファイルに適用されます。たとえば、次の例では ASP1 が ASP2 を呼び出しています。ASP2 の処理中にトランザクションが中止された場合、ASP2 の OnTransactionAbort (存在する場合) が呼び出されます。ASP2 の処理が完了すると、ASP1 の OnTransactionAbort (存在する場合) が呼び出されます。

例1.Executeの例

次の例は、サーバーのスクリプトの処理時間が 100 秒を超えた場合に、スクリプトをタイムアウトとして終了します。

ASP1.asp:

1
2
3
4
5
6
7
8
9
<%@ Transaction=Required%>
<%
  Server.Execute ("ASP2.asp")

  Sub OnTransactionAbort
  End Sub
  Sub OnTransactionCommit
  End Sub
%>

ASP2.asp:

1
2
3
4
5
6
7
<%@ Transaction=Required %>
<%
  Sub OnTransactionAbort
  End Sub
  Sub OnTransactionCommit
  End Sub
%>

Transfer、OnTransactionAbort、OnTransactionCommit も参照ください。