HttpResponse.RedirectToRoutePermanent Methode

Definition

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten, einem Routennamen oder beidem aus.

Überlädt

Name Beschreibung
RedirectToRoutePermanent(String, Object)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe der Routenparameterwerte und des Namens der Route aus, die der neuen URL entspricht.

RedirectToRoutePermanent(Object)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.

RedirectToRoutePermanent(String)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe eines Routennamens aus.

RedirectToRoutePermanent(RouteValueDictionary)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.

RedirectToRoutePermanent(String, RouteValueDictionary)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten und einem Routennamen aus.

RedirectToRoutePermanent(String, Object)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe der Routenparameterwerte und des Namens der Route aus, die der neuen URL entspricht.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Object ^ routeValues);
public void RedirectToRoutePermanent(string routeName, object routeValues);
member this.RedirectToRoutePermanent : string * obj -> unit
Public Sub RedirectToRoutePermanent (routeName As String, routeValues As Object)

Parameter

routeName
String

Der Name der Route.

routeValues
Object

Die Werte des Routenparameters.

Ausnahmen

Keine Route entspricht den angegebenen Routenparametern.

Die Umleitung wurde versucht, nachdem die HTTP-Header gesendet wurden.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer benannten Route Product umzuleiten und parameter, die benannt productid sind, und category.

Response.RedirectToRoutePermanent("Product",
  New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoutePermanent("Product",
  new { productid = "1", category = "widgets" });

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der RedirectPermanent Methode mit dem zweiten Parameter, der auf false.

Diese Methode konvertiert das Objekt, das mithilfe des routeValues Konstruktors in System.Web.Routing.RouteValueDictionary ein RouteValueDictionary.RouteValueDictionary(Object) Objekt übergeben wird. Die RouteCollection.GetVirtualPath Methode wird dann aufgerufen, um die URL zu bestimmen.

ASP.NET führt die Umleitung durch Zurückgeben eines 301 HTTP-Statuscodes aus.

Weitere Informationen

Gilt für:

RedirectToRoutePermanent(Object)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.

public:
 void RedirectToRoutePermanent(System::Object ^ routeValues);
public void RedirectToRoutePermanent(object routeValues);
member this.RedirectToRoutePermanent : obj -> unit
Public Sub RedirectToRoutePermanent (routeValues As Object)

Parameter

routeValues
Object

Die Werte des Routenparameters.

Ausnahmen

Keine Route entspricht den angegebenen Routenparametern.

Die Umleitung wurde versucht, nachdem die HTTP-Header gesendet wurden.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route mit Parametern umzuleiten, die benannt productid sind und category.

Response.RedirectToRoutePermanent(
  New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoutePermanent(
  new { productid = "1", category = "widgets" });

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der RedirectPermanent(String, Boolean) Methode mit dem zweiten Parameter, der auf false.

Diese Methode konvertiert das Objekt, das mithilfe des routeValues Konstruktors in System.Web.Routing.RouteValueDictionary ein RouteValueDictionary.RouteValueDictionary(Object) Objekt übergeben wird. Die RouteCollection.GetVirtualPath Methode wird dann aufgerufen, um die URL zu bestimmen.

ASP.NET führt die Umleitung durch Zurückgeben eines 301 HTTP-Statuscodes aus.

Weitere Informationen

Gilt für:

RedirectToRoutePermanent(String)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe eines Routennamens aus.

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

Parameter

routeName
String

Der Name der Route.

Ausnahmen

Keine Route entspricht den angegebenen Routenparametern.

Die Umleitung wurde versucht, nachdem die HTTP-Header gesendet wurden.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route umzuleiten, die benannt Productsist.

Response.RedirectToRoutePermanent("Products")
Response.RedirectToRoutePermanent("Products");

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der RedirectPermanent(String, Boolean) Methode mit dem zweiten Parameter, der auf false.

Diese Methode konvertiert den Routennamen, der mithilfe der routeName Methode in RouteCollection.GetVirtualPath eine URL übergeben wird.

ASP.NET führt die Umleitung durch Zurückgeben eines 301 HTTP-Statuscodes aus.

Weitere Informationen

Gilt für:

RedirectToRoutePermanent(RouteValueDictionary)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.

public:
 void RedirectToRoutePermanent(System::Web::Routing::RouteValueDictionary ^ routeValues);
public void RedirectToRoutePermanent(System.Web.Routing.RouteValueDictionary routeValues);
member this.RedirectToRoutePermanent : System.Web.Routing.RouteValueDictionary -> unit
Public Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)

Parameter

routeValues
RouteValueDictionary

Die Werte des Routenparameters.

Ausnahmen

Keine Route entspricht den angegebenen Routenparametern.

Die Umleitung wurde versucht, nachdem die HTTP-Header gesendet wurden.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route mit Parametern umzuleiten, die benannt productid sind und category.

Response.RedirectToRoutePermanent(
  new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoutePermanent(
  new RouteValueDictionary {productId="1", category="widgets"});

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der Redirect(String, Boolean) Methode mit dem zweiten Parameter, der auf false.

Diese Methode ruft die RouteCollection.GetVirtualPath Methode auf, um die URL zu bestimmen.

ASP.NET führt die Umleitung durch Zurückgeben eines 301 HTTP-Statuscodes aus.

Weitere Informationen

Gilt für:

RedirectToRoutePermanent(String, RouteValueDictionary)

Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten und einem Routennamen aus.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);
public void RedirectToRoutePermanent(string routeName, System.Web.Routing.RouteValueDictionary routeValues);
member this.RedirectToRoutePermanent : string * System.Web.Routing.RouteValueDictionary -> unit
Public Sub RedirectToRoutePermanent (routeName As String, routeValues As RouteValueDictionary)

Parameter

routeName
String

Der Name der Route.

routeValues
RouteValueDictionary

Die Werte des Routenparameters.

Ausnahmen

Keine Route entspricht den angegebenen Routenparametern.

Die Umleitung wurde versucht, nachdem die HTTP-Header gesendet wurden.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer benannten Route Product umzuleiten und parameter, die benannt productid sind, und category.

Response.RedirectToRoutePermanent("Product",
  new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoutePermanent("Product",
  new RouteValueDictionary {productId="1", category="widgets"});

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der Redirect(String, Boolean) Methode mit dem zweiten Parameter, der auf false.

Diese Methode ruft die RouteCollection.GetVirtualPath Methode auf, um die URL zu bestimmen.

ASP.NET führt die Umleitung durch Zurückgeben eines 301 HTTP-Statuscodes aus.

Weitere Informationen

Gilt für: