HttpResponse.Redirect Method (String) (System.Web)

.NET Framework Class Library

HttpResponse..::.Redirect Method (String)

Redirects a client to a new URL and specifies the new URL.

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

Syntax

Visual Basic (Declaration)

Public Sub Redirect ( _
    url As String _
)

Visual Basic (Usage)

Dim instance As HttpResponse
Dim url As String

instance.Redirect(url)

public void Redirect(
    string url
)

Visual C++

public:
void Redirect(
    String^ url
)

JScript

public function Redirect(
    url : String
)

Parameters

url: Type: System..::.String
The target location.

Exceptions

Exception	Condition
HttpException	A redirection is attempted after the HTTP headers have been sent.

Remarks

Calling Redirect is equivalent to calling Redirect with the second parameter set to true.

Redirect calls End which throws a ThreadAbortException exception upon completion.

Note:
For mobile pages only, if your application relies on cookieless sessions, or might receive requests from mobile devices that require cookieless sessions, using a tilde (~) in a path can result in creating a new session and potentially losing session data. To set a property on a mobile control with a path such as "~/path", resolve the path using ResolveUrl "~/path" before assigning it to the property.

Note:

For mobile pages only, if your application relies on cookieless sessions, or might receive requests from mobile devices that require cookieless sessions, using a tilde (~) in a path can result in creating a new session and potentially losing session data. To set a property on a mobile control with a path such as "~/path", resolve the path using ResolveUrl "~/path" before assigning it to the property.

Examples

The following example forces an unconditional redirection to another Web site.

Visual Basic

Response.Redirect("http://www.microsoft.com/gohere/look.htm")

Response.Redirect("http://www.microsoft.com/gohere/look.htm");

JScript

Response.Redirect("http://www.microsoft.com/gohere/look.htm")

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference