HttpServerUtilityWrapper.Transfer Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Terminates execution of the current process and starts execution of a different process for the current request.

Overloads

Transfer(String)	Terminates execution of the current process and starts execution of a page or handler that is specified with a URL.
Transfer(String, Boolean)	Terminates execution of the current page and starts execution of a different page or handler by using the specified URL and a value that specifies whether to clear the QueryString and Form collections.
Transfer(IHttpHandler, Boolean)	Terminates execution of the current process and starts execution of a new request, using a custom HTTP handler and a value that specifies whether to clear the QueryString and Form collections.

Transfer(String)

Terminates execution of the current process and starts execution of a page or handler that is specified with a URL.

public:
 override void Transfer(System::String ^ path);

public override void Transfer (string path);

override this.Transfer : string -> unit

Public Overrides Sub Transfer (path As String)

Parameters

path

String

The URL of the page or handler to execute.

Transfer(String, Boolean)

Terminates execution of the current page and starts execution of a different page or handler by using the specified URL and a value that specifies whether to clear the QueryString and Form collections.

public:
 override void Transfer(System::String ^ path, bool preserveForm);

public override void Transfer (string path, bool preserveForm);

override this.Transfer : string * bool -> unit

Public Overrides Sub Transfer (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

ApplicationException

The current page request is a callback.

Transfer(IHttpHandler, Boolean)

Terminates execution of the current process and starts execution of a new request, using a custom HTTP handler and a value that specifies whether to clear the QueryString and Form collections.

public:
 override void Transfer(System::Web::IHttpHandler ^ handler, bool preserveForm);

public override void Transfer (System.Web.IHttpHandler handler, bool preserveForm);

override this.Transfer : System.Web.IHttpHandler * bool -> unit

Public Overrides Sub Transfer (handler As IHttpHandler, preserveForm As Boolean)

Parameters

handler

IHttpHandler

The HTTP handler to transfer the current request to.

preserveForm

Boolean

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

Exceptions

ApplicationException

The current page request is a callback.