Edit

Share via


HttpServerUtilityWrapper.TransferRequest Method

Definition

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

The request requires the integrated pipeline mode of IIS 7.0.

The server is not available to handle the request.

The path parameter is null.

The path parameter is invalid.

Applies to

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

The request requires the integrated pipeline mode of IIS 7.0.

The server is not available to handle the request.

The path parameter is null.

The path parameter is invalid.

Applies to

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

The request requires IIS 7.0 running in integrated mode.

The server is not available to handle the request.

The path parameter is null.

The path parameter is invalid.

Applies to

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

The request requires the integrated pipeline mode of IIS 7.0.

The server is not available to handle the request.

The path parameter is null.

The path parameter is invalid.

Applies to