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 パラメーターが正しくありません。

注釈

このメソッドオーバーロードは、パラメーターをTransferRequest設定し、パラメーターをpreserveForm設定しfalse、パラメーターをmethod``null設定して、headersパラメーター null``preserveUser trueを . 詳細については、オーバーロードの「解説」セクションを 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 パラメーターが正しくありません。

注釈

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

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

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 を変更したり、元の要求が受信された場所を指定する特別なヘッダーを追加したりすることができます。

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

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)セクションを参照してください。