HttpServerUtilityWrapper.TransferRequest Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Asynchronously executes the end point at the specified URL.

Overloads

TransferRequest(String)	Asynchronously executes the end point at the specified URL.
TransferRequest(String, Boolean)	Asynchronously executes the endpoint at the specified URL and specifies whether to clear the QueryString and Form collections.
TransferRequest(String, Boolean, String, NameValueCollection)	Asynchronously executes the endpoint at the specified URL by using the specified HTTP method and headers.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, path, and options to preserve form values and preserve the user identity.

TransferRequest(String)

Asynchronously executes the end point at the specified URL.

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

public override void TransferRequest (string path);

override this.TransferRequest : string -> unit

Public Overrides Sub TransferRequest (path As String)

Parameters

path

String

The URL of the page or handler to execute.

Exceptions

PlatformNotSupportedException

The request requires the integrated pipeline mode of IIS 7.0.

HttpException

The server is not available to handle the request.

ArgumentNullException

The path parameter is null.

ArgumentException

The path parameter is invalid.

TransferRequest(String, Boolean)

Asynchronously executes the endpoint at the specified URL and specifies whether to clear the QueryString and Form collections.

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

public override void TransferRequest (string path, bool preserveForm);

override this.TransferRequest : string * bool -> unit

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

Parameters

path

String

The URL of the page to execute.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

Exceptions

PlatformNotSupportedException

The request requires the integrated pipeline mode of IIS 7.0.

HttpException

The server is not available to handle the request.

ArgumentNullException

The path parameter is null.

ArgumentException

The path parameter is invalid.

TransferRequest(String, Boolean, String, NameValueCollection)

Asynchronously executes the endpoint at the specified URL by using the specified HTTP method and headers.

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

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

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

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

Parameters

path

String

The URL of the page or handler to execute.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

method

String

The HTTP method (GET, POST, and so on) to use for the new request. If null, the HTTP method of the original request is used.

headers

NameValueCollection

A collection of request headers for the new request.

Exceptions

PlatformNotSupportedException

The request requires IIS 7.0 running in integrated mode.

HttpException

The server is not available to handle the request.

ArgumentNullException

The path parameter is null.

ArgumentException

The path parameter is invalid.

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

Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, path, and options to preserve form values and preserve the user identity.

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

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

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

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

Parameters

path

String

The path.

preserveForm

Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

method

String

The HTTP method to use in the new request.

headers

NameValueCollection

A NameValueCollection object that contains request headers for the new request.

preserveUser

Boolean

true to preserve the user identity; otherwise, false. Other overloads of this method call this method overload with the preserveUser parameter set to true.

Exceptions

PlatformNotSupportedException

The request requires the integrated pipeline mode of IIS 7.0.

HttpException

The server is not available to handle the request.

ArgumentNullException

The path parameter is null.

ArgumentException

The path parameter is invalid.