HttpResponse.RedirectToRoutePermanent Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten, einem Routennamen oder beiden Angaben aus.

Überlädt

RedirectToRoutePermanent(String, Object)	Führt mit den Routenparameterwerten und dem Namen der Route, die der neuen URL entsprechen, eine permanente Umleitung von einer angeforderten URL an eine neue URL aus.
RedirectToRoutePermanent(Object)	Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten aus.
RedirectToRoutePermanent(String)	Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit einem Routennamen aus.
RedirectToRoutePermanent(RouteValueDictionary)	Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten aus.
RedirectToRoutePermanent(String, RouteValueDictionary)	Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten und einem Routennamen aus.

RedirectToRoutePermanent(String, Object)

Führt mit den Routenparameterwerten und dem Namen der Route, die der neuen URL entsprechen, eine permanente Umleitung von einer angeforderten URL an eine neue URL aus.

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 Routenparameterwerte.

Ausnahmen

InvalidOperationException

Den angegebenen Routenparametern entspricht keine Route.

HttpException

Nach dem Senden der HTTP-Header wurde eine Umleitung versucht.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode aufrufen, um zu einer Route umzuleiten, die den Namen hat Product und parameter mit dem Namen productid und categoryenthält.

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, bei der der zweite Parameter auf falsefestgelegt ist.

Diese Methode konvertiert das Objekt, das an routeValues ein System.Web.Routing.RouteValueDictionary Objekt übergeben wird, indem der RouteValueDictionary.RouteValueDictionary(Object) Konstruktor verwendet 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-status-Codes aus.

Weitere Informationen

• ASP.NET-Routing

RedirectToRoutePermanent(Object)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit 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 Routenparameterwerte.

Ausnahmen

InvalidOperationException

Den angegebenen Routenparametern entspricht keine Route.

HttpException

Nach dem Senden der HTTP-Header wurde eine Umleitung versucht.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route umzuleiten, die Parameter mit dem Namen productid und categoryenthält.

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, bei der der zweite Parameter auf falsefestgelegt ist.

Diese Methode konvertiert das Objekt, das an routeValues ein System.Web.Routing.RouteValueDictionary Objekt übergeben wird, indem der RouteValueDictionary.RouteValueDictionary(Object) Konstruktor verwendet 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-status-Codes aus.

Weitere Informationen

• ASP.NET-Routing

RedirectToRoutePermanent(String)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit einem Routennamen 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

InvalidOperationException

Den angegebenen Routenparametern entspricht keine Route.

HttpException

Nach dem Senden der HTTP-Header wurde eine Umleitung versucht.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route mit dem Namen Productsumzuleiten.

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Es entspricht dem Aufrufen der RedirectPermanent(String, Boolean) -Methode, bei der der zweite Parameter auf falsefestgelegt ist.

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

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

Weitere Informationen

• ASP.NET-Routing

RedirectToRoutePermanent(RouteValueDictionary)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit 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 Routenparameterwerte.

Ausnahmen

InvalidOperationException

Den angegebenen Routenparametern entspricht keine Route.

HttpException

Nach dem Senden der HTTP-Header wurde eine Umleitung versucht.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode aufrufen, um zu einer Route umzuleiten, die Parameter mit dem Namen productid und categoryenthält.

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, bei der der zweite Parameter auf falsefestgelegt ist.

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-status-Codes aus.

Weitere Informationen

• ASP.NET-Routing

RedirectToRoutePermanent(String, RouteValueDictionary)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit 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 Routenparameterwerte.

Ausnahmen

InvalidOperationException

Den angegebenen Routenparametern entspricht keine Route.

HttpException

Nach dem Senden der HTTP-Header wurde eine Umleitung versucht.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode aufrufen, um zu einer Route umzuleiten, die den Namen hat Product und parameter mit dem Namen productid und categoryenthält.

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, bei der der zweite Parameter auf falsefestgelegt ist.

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-status-Codes aus.

Weitere Informationen

• ASP.NET-Routing