HttpResponse.RedirectToRoutePermanent Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Realiza una redirección permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta, un nombre de ruta o ambos.

Sobrecargas

RedirectToRoutePermanent(String, Object)	Realiza un redireccionamiento permanente de la dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro y el nombre de la ruta que corresponden a la nueva dirección URL.
RedirectToRoutePermanent(Object)	Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.
RedirectToRoutePermanent(String)	Realiza una redirección permanente de una dirección URL solicitada a una nueva dirección URL mediante un nombre de ruta.
RedirectToRoutePermanent(RouteValueDictionary)	Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.
RedirectToRoutePermanent(String, RouteValueDictionary)	Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta y un nombre de ruta.

RedirectToRoutePermanent(String, Object)

Realiza un redireccionamiento permanente de la dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro y el nombre de la ruta que corresponden a la nueva dirección URL.

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)

Parámetros

routeName

String

Nombre de la ruta.

routeValues

Object

Valores de parámetro de la ruta.

Excepciones

InvalidOperationException

No existe ninguna ruta que corresponde al conjunto especificado de parámetros de ruta.

HttpException

Se intentó redirigir una vez enviados los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a este método para redirigir a una ruta denominada Product y que tiene parámetros denominados productid y category.

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

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

Comentarios

Este método se proporciona para facilitar la codificación. Equivale a llamar al RedirectPermanent método con el segundo parámetro establecido en false.

Este método convierte el objeto que se pasa routeValues a un System.Web.Routing.RouteValueDictionary objeto mediante el RouteValueDictionary.RouteValueDictionary(Object) constructor . A RouteCollection.GetVirtualPath continuación, se llama al método para determinar la dirección URL.

ASP.NET realiza el redireccionamiento devolviendo un código de estado HTTP 301.

Consulte también

• Enrutamiento de ASP.NET

RedirectToRoutePermanent(Object)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.

public:
 void RedirectToRoutePermanent(System::Object ^ routeValues);

public void RedirectToRoutePermanent (object routeValues);

member this.RedirectToRoutePermanent : obj -> unit

Public Sub RedirectToRoutePermanent (routeValues As Object)

Parámetros

routeValues

Object

Valores de parámetro de la ruta.

Excepciones

InvalidOperationException

No existe ninguna ruta que corresponde al conjunto especificado de parámetros de ruta.

HttpException

Se intentó redirigir una vez enviados los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a este método para redirigir a una ruta que tiene parámetros denominados productid y category.

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

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

Comentarios

Este método se proporciona para facilitar la codificación. Equivale a llamar al RedirectPermanent(String, Boolean) método con el segundo parámetro establecido en false.

Este método convierte el objeto que se pasa routeValues a un System.Web.Routing.RouteValueDictionary objeto mediante el RouteValueDictionary.RouteValueDictionary(Object) constructor . A RouteCollection.GetVirtualPath continuación, se llama al método para determinar la dirección URL.

ASP.NET realiza el redireccionamiento devolviendo un código de estado HTTP 301.

Consulte también

• Enrutamiento de ASP.NET

RedirectToRoutePermanent(String)

Realiza una redirección permanente de una dirección URL solicitada a una nueva dirección URL mediante un nombre de ruta.

public:
 void RedirectToRoutePermanent(System::String ^ routeName);

public void RedirectToRoutePermanent (string routeName);

member this.RedirectToRoutePermanent : string -> unit

Public Sub RedirectToRoutePermanent (routeName As String)

Parámetros

routeName

String

Nombre de la ruta.

Excepciones

InvalidOperationException

No existe ninguna ruta que corresponde al conjunto especificado de parámetros de ruta.

HttpException

Se intentó redirigir una vez enviados los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a este método para redirigir a una ruta denominada Products.

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Comentarios

Este método se proporciona para facilitar la codificación. Equivale a llamar al RedirectPermanent(String, Boolean) método con el segundo parámetro establecido en false.

Este método convierte el nombre de ruta que se pasa a routeName una dirección URL mediante el RouteCollection.GetVirtualPath método .

ASP.NET realiza el redireccionamiento devolviendo un código de estado HTTP 301.

Consulte también

• Enrutamiento de ASP.NET

RedirectToRoutePermanent(RouteValueDictionary)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta.

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)

Parámetros

routeValues

RouteValueDictionary

Valores de parámetro de la ruta.

Excepciones

InvalidOperationException

No existe ninguna ruta que corresponde al conjunto especificado de parámetros de ruta.

HttpException

Se intentó redirigir una vez enviados los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a este método para redirigir a una ruta que tiene parámetros denominados productid y category.

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

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

Comentarios

Este método se proporciona para facilitar la codificación. Equivale a llamar al Redirect(String, Boolean) método con el segundo parámetro establecido en false.

Este método llama al RouteCollection.GetVirtualPath método para determinar la dirección URL.

ASP.NET realiza el redireccionamiento devolviendo un código de estado HTTP 301.

Consulte también

• Enrutamiento de ASP.NET

RedirectToRoutePermanent(String, RouteValueDictionary)

Realiza un redireccionamiento permanente de una dirección URL solicitada a una nueva dirección URL mediante los valores de parámetro de la ruta y un nombre de ruta.

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)

Parámetros

routeName

String

Nombre de la ruta.

routeValues

RouteValueDictionary

Valores de parámetro de la ruta.

Excepciones

InvalidOperationException

No existe ninguna ruta que corresponde al conjunto especificado de parámetros de ruta.

HttpException

Se intentó redirigir una vez enviados los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se muestra cómo llamar a este método para redirigir a una ruta denominada Product y que tiene parámetros denominados productid y category.

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

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

Comentarios

Este método se proporciona para facilitar la codificación. Equivale a llamar al Redirect(String, Boolean) método con el segundo parámetro establecido en false.

Este método llama al RouteCollection.GetVirtualPath método para determinar la dirección URL.

ASP.NET realiza el redireccionamiento devolviendo un código de estado HTTP 301.

Consulte también

• Enrutamiento de ASP.NET