HttpResponseWrapper.RedirectPermanent Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Performs a permanent redirect from a requested URL to the specified URL.

Overloads

RedirectPermanent(String, Boolean)	Performs a permanent redirect from the requested URL to the specified URL, and provides the option to complete the response.
RedirectPermanent(String)	Performs a permanent redirect from the requested URL to the specified URL.

RedirectPermanent(String, Boolean)

Performs a permanent redirect from the requested URL to the specified URL, and provides the option to complete the response.

public:
 override void RedirectPermanent(System::String ^ url, bool endResponse);

public override void RedirectPermanent (string url, bool endResponse);

override this.RedirectPermanent : string * bool -> unit

Public Overrides Sub RedirectPermanent (url As String, endResponse As Boolean)

Parameters

url

String

The URL to redirect the request to.

endResponse

Boolean

true to terminate the response; otherwise false. The default is false.

Exceptions

ArgumentNullException

url is null.

ArgumentException

url includes a newline character (\n).

Remarks

The RedirectPermanent(String, Boolean) method overload provides a 301 HTTP status code in the response and also includes the URL to redirect the request to. This method overload provides the option to specify whether to terminate the response or to complete it after the redirect has been performed. A 301 HTTP status code is a standard code in an HTTP response. It indicates that a permanent redirect exists, and it provides the redirect location.

RedirectPermanent(String)

Performs a permanent redirect from the requested URL to the specified URL.

public:
 override void RedirectPermanent(System::String ^ url);

public override void RedirectPermanent (string url);

override this.RedirectPermanent : string -> unit

Public Overrides Sub RedirectPermanent (url As String)

Parameters

url

String

The URL to redirect the request to.

Exceptions

ArgumentNullException

url is null.

ArgumentException

url includes a newline character (\n).

Remarks

The RedirectPermanent(String) method overload provides a 301 HTTP status code in the response and also includes the URL to redirect the request to. A 301 HTTP status code is a standard code in an HTTP response. It indicates that a permanent redirect exists, and it provides the redirect location.

Calling the RedirectPermanent(String) method terminates the rest of the response.