HttpServerUtility.TransferRequest Method (String, Boolean, String, NameValueCollection, Boolean)

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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.

Namespace:   System.Web
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).

.NET Framework
Available since 4.5
Return to top
Show: