HttpResponse.RedirectPermanent Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Performs a permanent redirection from a requested URL to a specified URL.

Overloads

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

RedirectPermanent(String, Boolean)

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

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

public void RedirectPermanent (string url, bool endResponse);

member this.RedirectPermanent : string * bool -> unit

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

Parameters

url

String

The location 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 includes the URL to redirect the request to. This method overload also provides the option to specify whether to terminate or to complete the response after the redirection has been performed. A 301 HTTP status code is a standard code in an HTTP response. It indicates that a permanent redirection exists, and it provides the redirection location.

RedirectPermanent(String)

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

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

public void RedirectPermanent (string url);

member this.RedirectPermanent : string -> unit

Public Sub RedirectPermanent (url As String)

Parameters

url

String

The location 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 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 redirection exists, and it provides the redirection location.

Calling the RedirectPermanent(String) method overload terminates the response.