HttpServerUtilityWrapper.TransferRequest Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
