HttpServerUtilityBase.Transfer 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, terminates execution of the current process and starts execution of a different process for the current request.
Overloads
Transfer(String) |
When overridden in a derived class, terminates execution of the current process and starts execution of a page or handler that is specified with a URL. |
Transfer(String, Boolean) |
When overridden in a derived class, 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) |
When overridden in a derived class, 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)
When overridden in a derived class, terminates execution of the current process and starts execution of a page or handler that is specified with a URL.
public:
virtual void Transfer(System::String ^ path);
public virtual void Transfer (string path);
abstract member Transfer : string -> unit
override this.Transfer : string -> unit
Public Overridable Sub Transfer (path As String)
Parameters
- path
- String
The URL of the page or handler to execute.
Exceptions
Always.
Applies to
Transfer(String, Boolean)
When overridden in a derived class, 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:
virtual void Transfer(System::String ^ path, bool preserveForm);
public virtual void Transfer (string path, bool preserveForm);
abstract member Transfer : string * bool -> unit
override this.Transfer : string * bool -> unit
Public Overridable 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
Always.
Applies to
Transfer(IHttpHandler, Boolean)
When overridden in a derived class, 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:
virtual void Transfer(System::Web::IHttpHandler ^ handler, bool preserveForm);
public virtual void Transfer (System.Web.IHttpHandler handler, bool preserveForm);
abstract member Transfer : System.Web.IHttpHandler * bool -> unit
override this.Transfer : System.Web.IHttpHandler * bool -> unit
Public Overridable 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
Always.