This documentation is archived and is not being maintained.

HttpServerUtility.TransferRequest Method (String, Boolean)

Performs an asynchronous execution of the specified URL and preserves query string parameters.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)

public void TransferRequest(
	string path,
	bool preserveForm
)

Parameters

path
Type: System.String

The URL path of the new page on the server to execute.

preserveForm
Type: System.Boolean

true to preserve the QueryString and Form collections; false to clear the QueryString and Form collections.

ExceptionCondition
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.

This overload calls the TransferRequest overload with the preserveForm parameter set to the value passed in, the method parameter set to null, and the headers parameter set to null. For more information, see the "Remarks" section of the TransferRequest overload.

TransferRequest is introduced in the .NET Framework version 3.5. For more information, see .NET Framework 3.5 Architecture.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5 SP1, 3.0 SP1, 2.0 SP1
Show: