HttpResponse.Redirect HttpResponse.Redirect HttpResponse.Redirect HttpResponse.Redirect Method

Definition

Leitet einen Client zu einer neuen URL um.Redirects a client to a new URL.

Überlädt

Redirect(String) Redirect(String) Redirect(String) Redirect(String)

Leitet eine Anforderung an eine neue URL um und gibt die neue URL an.Redirects a request to a new URL and specifies the new URL.

Redirect(String, Boolean) Redirect(String, Boolean) Redirect(String, Boolean) Redirect(String, Boolean)

Leitet einen Client zu einer neuen URL um.Redirects a client to a new URL. Gibt die neue URL an und meldet, ob die Ausführung der aktuellen Seite beendet werden soll.Specifies the new URL and whether execution of the current page should terminate.

Redirect(String) Redirect(String) Redirect(String) Redirect(String)

Leitet eine Anforderung an eine neue URL um und gibt die neue URL an.Redirects a request to a new URL and specifies the new URL.

public:
 void Redirect(System::String ^ url);
public void Redirect (string url);
member this.Redirect : string -> unit
Public Sub Redirect (url As String)

Parameter

url
String String String String

Der Zielort.The target location. Dies kann ein zur Anwendung relativer virtueller Pfad sein.This may be an application-relative virtual path.

Ausnahmen

Nach dem Senden der HTTP-Header wird eine Umleitung versucht.A redirection is attempted after the HTTP headers have been sent.

Beispiele

Im folgenden Beispiel wird eine nicht bedingte Umleitung an eine andere Website an.The following example forces an unconditional redirection to another Web site.

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

Hinweise

Aufrufen von Redirect entspricht dem Aufruf Redirect mit den zweiten Parameter auf true.Calling Redirect is equivalent to calling Redirect with the second parameter set to true.

Redirect Aufrufe End welche löst eine ThreadAbortException Ausnahme nach Abschluss.Redirect calls End which throws a ThreadAbortException exception upon completion. Diese Ausnahme hat sich nachteilig auf die Leistung der Webanwendung.This exception has a detrimental effect on Web application performance. Daher wird empfohlen, anstelle diese Überladung, die Sie verwenden die HttpResponse.Redirect(String, Boolean) überladen, und übergeben Sie false für die endResponse -Parameter, und rufen Sie dann die CompleteRequest Methode.Therefore, we recommend that instead of this overload you use the HttpResponse.Redirect(String, Boolean) overload and pass false for the endResponse parameter, and then call the CompleteRequest method. Weitere Informationen finden Sie unter der Methode End.For more information, see the End method.

Hinweis

Verwenden Sie für mobile Seiten nur, wenn Ihre Anwendung für Sitzungen ohne Cookies verwendet, oder Anforderungen von mobilen Geräten, die Sitzungen ohne Cookies erfordern möglicherweise, eine Tilde (~) in einem Pfad können führen zu eine neue Sitzung zu erstellen und Sitzung verloren gehen Daten.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. Zum Festlegen einer Eigenschaft eines mobilen Steuerelements mit einem Pfad wie z. B. "~/Path", lösen Sie den Pfad mit ResolveUrl " ~ /Path" vor der-Eigenschaft zuweisen.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.

ASP.NET führt die Umleitung von einer HTTP-Statuscode 302 zurückgeben.ASP.NET performs the redirection by returning a 302 HTTP status code. Eine alternative Möglichkeit zum Übertragen von Steuerelement zu einer anderen Seite ist die Transfer Methode.An alternative way to transfer control to another page is the Transfer method. Die Transfer Methode ist in der Regel effizienter, da sie nicht über einen Roundtrip an dem Client führt.The Transfer method is typically more efficient because it does not cause a round trip to the client. Weitere Informationen finden Sie unter Vorgehensweise: Benutzer zu einer anderen Seite umleiten.For more information, see How to: Redirect Users to Another Page.

Redirect(String, Boolean) Redirect(String, Boolean) Redirect(String, Boolean) Redirect(String, Boolean)

Leitet einen Client zu einer neuen URL um.Redirects a client to a new URL. Gibt die neue URL an und meldet, ob die Ausführung der aktuellen Seite beendet werden soll.Specifies the new URL and whether execution of the current page should terminate.

public:
 void Redirect(System::String ^ url, bool endResponse);
public void Redirect (string url, bool endResponse);
member this.Redirect : string * bool -> unit
Public Sub Redirect (url As String, endResponse As Boolean)

Parameter

url
String String String String

Der Zielspeicherort.The location of the target.

endResponse
Boolean Boolean Boolean Boolean

Gibt an, ob die Ausführung der aktuellen Seite beendet werden soll.Indicates whether execution of the current page should terminate.

Ausnahmen

url enthält ein Zeilenumbruchzeichen.url contains a newline character.

Nach dem Senden der HTTP-Header wird eine Umleitung versucht.A redirection is attempted after the HTTP headers have been sent.

Die Seitenanforderung ist das Ergebnis eines Rückrufs.The page request is the result of a callback.

Beispiele

Im folgenden Beispiel wird die IsClientConnected Eigenschaft zu überprüfen, ob der Client, der die Seite anfordert, wird mit dem Server verbunden bleibt.The following example uses the IsClientConnected property to check whether the client that is requesting the page remains connected to the server. Wenn IsClientConnected true ist, ruft der Code die Redirect -Methode, und der Client eine andere Seite angezeigt wird.If IsClientConnected is true, the code calls the Redirect method, and the client will view another page. Wenn IsClientConnected ist "false", und der Code ruft dann die End -Methode und die gesamte seitenverarbeitung wird beendet.If IsClientConnected is false, then the code calls the End method and all page processing is terminated.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {
        // Check whether the browser remains
        // connected to the server.
        if (Response.IsClientConnected)
        {
            // If still connected, redirect
            // to another page. 
            Response.Redirect("Page2CS.aspx", false);
        }
        else
        {
            // If the browser is not connected
            // stop all response processing.
            Response.End();
        }
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Private Sub Page_Load(sender As Object, e As EventArgs)

        ' Check whether the browser remains
        ' connected to the server.
        If (Response.IsClientConnected) Then

            ' If still connected, redirect
            ' to another page.             
            Response.Redirect("Page2VB.aspx", false)
        Else
            ' If the browser is not connected
            ' stop all response processing.
            Response.End()
        End If
    End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

Hinweise

Eine absolute URL (z. B. http://www.contoso.com/default.aspx) oder eine relative URL (z. B. "default.aspx") kann als Ziel angegeben werden, aber einige Browser möglicherweise eine relative URL abgelehnt.An absolute URL (for example, http://www.contoso.com/default.aspx) or a relative URL (for example, Default.aspx) can be specified for the target location but some browsers may reject a relative URL.

Bei Verwendung dieser Methode in einem Seite-Ereignishandler eine Anforderung beendet wird, für eine Seite, und starten Sie eine neue Anforderung für eine andere Seite festgelegt endResponse zu false und rufen Sie dann die CompleteRequest Methode.When you use this method in a page handler to terminate a request for one page and start a new request for another page, set endResponse to false and then call the CompleteRequest method. Bei Angabe von true für die endResponse Parameter, um diese Methode ruft die End -Methode für die ursprüngliche Anforderung, die auslöst, ein ThreadAbortException Ausnahme aus, wenn der Vorgang abgeschlossen ist.If you specify true for the endResponse parameter, this method calls the End method for the original request, which throws a ThreadAbortException exception when it completes. Diese Ausnahme hat sich nachteilig auf die Leistung der Webanwendung, weshalb übergeben false für die endResponse Parameter wird empfohlen.This exception has a detrimental effect on Web application performance, which is why passing false for the endResponse parameter is recommended. Weitere Informationen finden Sie unter der Methode End.For more information, see the End method.

Hinweis

Verwenden Sie für mobile Seiten, wenn Ihre Anwendung für Sitzungen ohne Cookies verwendet, oder Anforderungen von mobilen Geräten, die Sitzungen ohne Cookies erfordern möglicherweise, eine Tilde (~) in einem Pfad können eine neue Sitzung erstellen und Sie verlieren Sitzungsdaten.For mobile pages, 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 create a new session and potentially lose session data. Zum Festlegen einer Eigenschaft eines mobilen Steuerelements mit einem Pfad wie z. B. "~/Path", lösen Sie den Pfad mit ResolveUrl " ~ /Path" vor der-Eigenschaft zuweisen.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.

ASP.NET führt die Umleitung von einer HTTP-Statuscode 302 zurückgeben.ASP.NET performs the redirection by returning a 302 HTTP status code. Eine alternative Möglichkeit zum Übertragen von Steuerelement zu einer anderen Seite ist die Transfer Methode.An alternative way to transfer control to another page is the Transfer method. Die Transfer Methode ist in der Regel effizienter, da sie nicht über einen Roundtrip an dem Client führt.The Transfer method is typically more efficient because it does not cause a round trip to the client. Weitere Informationen finden Sie unter Vorgehensweise: Benutzer zu einer anderen Seite umleiten.For more information, see How to: Redirect Users to Another Page.

Gilt für: