HttpServerUtility::TransferRequest Method (String^, Boolean, String^, NameValueCollection^, Boolean)
Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.
Assembly: System.Web (in System.Web.dll)
public: void TransferRequest( String^ path, bool preserveForm, String^ method, NameValueCollection^ headers, bool preserveUser )
Parameters
- path
-
Type:
System::String^
The path.
- preserveForm
-
Type:
System::Boolean
true to preserve the Form collection; false to clear the Form collection.
- method
-
Type:
System::String^
The HTTP method to use in the new request.
- headers
-
Type:
System.Collections.Specialized::NameValueCollection^
A NameValueCollection object that contains request headers for the new request.
- preserveUser
-
Type:
System::Boolean
true to preserve the user identity; otherwise, false. The other method overloads of this method call this overload with this parameter set to true.
| Exception | Condition |
|---|---|
| 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. |
For more information, see the "Remarks" section in TransferRequest(String^, Boolean, String^, NameValueCollection^).
Available since 4.5