HttpServerUtilityBase.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.
When overridden in a derived class, asynchronously executes the end point at the specified URL.
Overloads
TransferRequest(String) |
When overridden in a derived class, asynchronously executes the end point at the specified URL. |
TransferRequest(String, Boolean) |
When overridden in a derived class, asynchronously executes the endpoint at the specified URL and specifies whether to clear the QueryString and Form collections. |
TransferRequest(String, Boolean, String, NameValueCollection) |
When overridden in a derived class, asynchronously executes the endpoint at the specified URL by using the specified HTTP method and headers. |
TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
When implemented in a derived class, asynchronously executes the end point at the specified URL, using the specified HTTP method, headers, path, and options to preserve form values and preserve the user identity. |
TransferRequest(String)
When overridden in a derived class, asynchronously executes the end point at the specified URL.
public:
virtual void TransferRequest(System::String ^ path);
public virtual void TransferRequest (string path);
abstract member TransferRequest : string -> unit
override this.TransferRequest : string -> unit
Public Overridable Sub TransferRequest (path As String)
Parameters
- path
- String
The URL of the page or handler to execute.
Exceptions
Always.
Applies to
TransferRequest(String, Boolean)
When overridden in a derived class, asynchronously executes the endpoint at the specified URL and specifies whether to clear the QueryString and Form collections.
public:
virtual void TransferRequest(System::String ^ path, bool preserveForm);
public virtual void TransferRequest (string path, bool preserveForm);
abstract member TransferRequest : string * bool -> unit
override this.TransferRequest : string * bool -> unit
Public Overridable Sub TransferRequest (path As String, preserveForm As Boolean)
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.
Exceptions
Always.
Applies to
TransferRequest(String, Boolean, String, NameValueCollection)
When overridden in a derived class, asynchronously executes the endpoint at the specified URL by using the specified HTTP method and headers.
public:
virtual void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);
public virtual void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);
abstract member TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit
override this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit
Public Overridable 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
Always.
Applies to
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)
When implemented in a derived class, asynchronously executes the end point at the specified URL, using the specified HTTP method, headers, path, and options to preserve form values and preserve the user identity.
public:
virtual void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);
public virtual void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);
abstract member TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit
override this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit
Public Overridable 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 for 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
.