HttpResponse.RedirectToRoutePermanent Método

Definição

Espaço de Nomes:: System.Web

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando valores de parâmetros de rota, um nome de rota, ou ambos.

Sobrecargas

Name	Description
RedirectToRoutePermanent(String, Object)	Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL, utilizando os valores dos parâmetros de rota e o nome da rota que corresponde à nova URL.
RedirectToRoutePermanent(Object)	Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando valores de parâmetros de rota.
RedirectToRoutePermanent(String)	Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando um nome de rota.
RedirectToRoutePermanent(RouteValueDictionary)	Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando valores de parâmetros de rota.
RedirectToRoutePermanent(String, RouteValueDictionary)	Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL, utilizando valores de parâmetros de rota e um nome de rota.

RedirectToRoutePermanent(String, Object)

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL, utilizando os valores dos parâmetros de rota e o nome da rota que corresponde à nova 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

O nome da rota.

routeValues: Object

Os valores dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que é nomeada Product e que tem parâmetros nomeados productid e category.

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

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

Observações

Este método é fornecido para maior conveniência de codificação. É equivalente a chamar o RedirectPermanent método com o segundo parâmetro definido em false.

Este método converte o objeto que é passado routeValues num System.Web.Routing.RouteValueDictionary objeto usando o RouteValueDictionary.RouteValueDictionary(Object) construtor. O RouteCollection.GetVirtualPath método é então chamado para determinar a URL.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 301.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoutePermanent(Object)

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando valores de parâmetros de rota.

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

Os valores dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota cujos parâmetros são nomeados productid e category.

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

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

Observações

Este método é fornecido para maior conveniência de codificação. É equivalente a chamar o RedirectPermanent(String, Boolean) método com o segundo parâmetro definido em false.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 301.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoutePermanent(String)

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando um nome de rota.

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

O nome da rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que se chama Products.

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Observações

Este método é fornecido para maior conveniência de codificação. É equivalente a chamar o RedirectPermanent(String, Boolean) método com o segundo parâmetro definido em false.

Este método converte o nome da rota que é passado routeName para uma URL usando o RouteCollection.GetVirtualPath método.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 301.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoutePermanent(RouteValueDictionary)

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL usando valores de parâmetros de rota.

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

Os valores dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota cujos parâmetros são nomeados productid e category.

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

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

Observações

Este método é fornecido para maior conveniência de codificação. É equivalente a chamar o Redirect(String, Boolean) método com o segundo parâmetro definido em false.

Este método chama o RouteCollection.GetVirtualPath método para determinar a URL.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 301.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoutePermanent(String, RouteValueDictionary)

Realiza um redirecionamento permanente de uma URL solicitada para uma nova URL, utilizando valores de parâmetros de rota e um nome de rota.

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

O nome da rota.

routeValues: RouteValueDictionary

Os valores dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que é nomeada Product e que tem parâmetros nomeados productid e category.

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

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

Observações

Este método é fornecido para maior conveniência de codificação. É equivalente a chamar o Redirect(String, Boolean) método com o segundo parâmetro definido em false.

Este método chama o RouteCollection.GetVirtualPath método para determinar a URL.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 301.

Ver também

Roteamento ASP.NET

Aplica-se a

Comentários

Esta página foi útil?