HttpServerUtility.TransferRequest メソッド

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

指定した URL の非同期実行を実行します。

オーバーロード

TransferRequest(String)	指定した URL の非同期実行を実行します。
TransferRequest(String, Boolean)	指定した URL の非同期実行を実行し、クエリ文字列パラメーターを保持します。
TransferRequest(String, Boolean, String, NameValueCollection)	指定した HTTP メソッドとヘッダーを使用して、指定した URL の非同期実行を実行します。
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	指定した HTTP メソッド、ヘッダー、パスを使用して、指定した URL の非同期実行を実行し、必要に応じてフォーム値とユーザー ID を保持します。

注釈

TransferRequest は.NET Framework バージョン 3.5 で導入されました。 .NET Framework の概要については、「バージョンと依存関係の」を参照してください。

TransferRequest(String)

指定した URL の非同期実行を実行します。

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

パラメーター

path

String

実行するサーバー上の新しいページの URL パス。

例外

PlatformNotSupportedException

要求には、IIS 7.0 の統合パイプライン モードが必要です。

HttpException

サーバーは要求を処理できません。

ArgumentNullException

path パラメーターは nullです。

ArgumentException

path パラメーターが無効です。

注釈

このメソッド オーバーロードは、preserveForm パラメーターを falseに設定し、method パラメーターを nullに設定し、headers パラメーターを nullに設定し、preserveUser パラメーターを trueに設定して、TransferRequest オーバーロードを呼び出します。 詳細については、オーバーロードの「解説」セクション TransferRequest(String, Boolean, String, NameValueCollection) 参照してください。

TransferRequest(String, Boolean)

指定した URL の非同期実行を実行し、クエリ文字列パラメーターを保持します。

public:
 void TransferRequest(System::String ^ path, bool preserveForm);

public void TransferRequest (string path, bool preserveForm);

member this.TransferRequest : string * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean)

パラメーター

path

String

実行するサーバー上の新しいページの URL パス。

preserveForm

Boolean

Form コレクションを保持する true。Form コレクションをクリアする false。

例外

PlatformNotSupportedException

要求には、IIS 7.0 の統合パイプライン モードが必要です。

HttpException

サーバーは要求を処理できません。

ArgumentNullException

path パラメーターは nullです。

ArgumentException

path パラメーターが無効です。

注釈

このオーバーロードは、渡された値に preserveForm パラメーターを設定し、method パラメーターを nullに設定し、headers パラメーターを nullに設定し、preserveUser パラメーターを trueに設定して、TransferRequest オーバーロードを呼び出します。 詳細については、TransferRequest(String, Boolean, String, NameValueCollection)の「解説」セクションを参照してください。

TransferRequest は、.NET Framework バージョン 3.5 で導入されています。 詳細については、「バージョンと依存関係の」を参照してください。

TransferRequest(String, Boolean, String, NameValueCollection)

指定した HTTP メソッドとヘッダーを使用して、指定した URL の非同期実行を実行します。

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);

public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

パラメーター

path

String

実行するサーバー上の新しいページの URL パス。

preserveForm

Boolean

Form コレクションを保持する true。Form コレクションをクリアする false。

method

String

新しい要求の実行に使用する HTTP メソッド。

headers

NameValueCollection

新しい要求の要求ヘッダーの NameValueCollection。

例外

PlatformNotSupportedException

要求には、統合モードで実行されている IIS 7.0 が必要です。

HttpException

サーバーは要求を処理できません。

ArgumentNullException

path パラメーターは nullです。

ArgumentException

path パラメーターが無効です。

注釈

このメソッドは、IIS 7.0 で統合パイプライン モードで実行する場合に使用され、適切な要求コンテキストでターゲット要求を実行しながら、あるリソースの種類から別のリソースの種類に要求処理を転送できます。 たとえば、TransferRequest メソッドを使用して、ASPX ページの要求を XML ページの要求に転送できます。

TransferRequest メソッドは、指定した URL の非同期子実行を次の条件で実行します。

• path パラメーターでクエリ文字列が指定されている場合は、新しいクエリ文字列として使用されます。 クエリ文字列が含まれていない場合は、要求のクエリ文字列が再利用されます。

• method パラメーターを指定すると、そのパラメーターが使用されます。 nullされている場合は、元の要求の HTTP メソッドが使用されます。

• preserveForm パラメーターが trueされている場合、要求の現在のエンティティ本文がターゲット要求で使用できるようになります。 これにより、フォームの投稿とアップロードを転送できます。

• ユーザー ID が元の要求で現在設定されている場合、その ID は新しい要求に転送されます。 これにより、認証された要求は、新しい要求の認証の結果を再利用できます。 ユーザーを転送しない場合は、転送する前に、元の要求でユーザーを null に設定します。

• headers パラメーターが指定されている場合、新しい要求は指定されたヘッダーで実行されます。 これは、新しい要求の要求ヘッダーと Cookie を変更したり、元の要求が受信された場所を指定する特別なヘッダーを追加したりするために使用できます。

  このメソッドは、preserveUser パラメーターを trueに設定して、TransferRequest(String, Boolean, String, NameValueCollection, Boolean) メソッドのオーバーロードを呼び出します。

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

指定した HTTP メソッド、ヘッダー、パスを使用して、指定した URL の非同期実行を実行し、必要に応じてフォーム値とユーザー ID を保持します。

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);

public void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

パラメーター

path

String

パス。

preserveForm

Boolean

Form コレクションを保持する true。Form コレクションをクリアする false。

method

String

新しい要求で使用する HTTP メソッド。

headers

NameValueCollection

新しい要求の要求ヘッダーを含む NameValueCollection オブジェクト。

preserveUser

Boolean

ユーザー ID を保持する true。それ以外の場合は、falseします。 このメソッドの他のメソッド オーバーロードは、このパラメーターを trueに設定してこのオーバーロードを呼び出します。

例外

PlatformNotSupportedException

要求には、IIS 7.0 の統合パイプライン モードが必要です。

HttpException

サーバーは要求を処理できません。

ArgumentNullException

path パラメーターは nullです。

ArgumentException

path パラメーターが無効です。

注釈

詳細については、TransferRequest(String, Boolean, String, NameValueCollection)の「解説」セクションを参照してください。