HttpResponse.RedirectToRoutePermanent Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro de rota, um nome de rota ou ambos.
Sobrecargas
| RedirectToRoutePermanent(String, Object) |
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando os valores de parâmetro de rota e de nome da rota que correspondem à nova URL. |
| RedirectToRoutePermanent(Object) |
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro de rota. |
| RedirectToRoutePermanent(String) |
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL usando um nome de rota. |
| RedirectToRoutePermanent(RouteValueDictionary) |
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro de rota. |
| RedirectToRoutePermanent(String, RouteValueDictionary) |
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro de rota e um nome de rota. |
RedirectToRoutePermanent(String, Object)
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando os valores de parâmetro de rota e de nome da rota que correspondem à nova URL.
public:
void RedirectToRoutePermanent(System::String ^ routeName, System::Object ^ routeValues);public void RedirectToRoutePermanent (string routeName, object routeValues);member this.RedirectToRoutePermanent : string * obj -> unitPublic Sub RedirectToRoutePermanent (routeName As String, routeValues As Object)Parâmetros
- routeName
- String
O nome da rota.
- routeValues
- Object
Os valores de parâmetro de rota.
Exceções
Nenhuma rota corresponde aos parâmetros de rotas especificados.
Houve uma tentativa de redirecionamento após o envio dos cabeçalhos HTTP.
Exemplos
O exemplo a seguir mostra como chamar esse método para redirecionar para uma rota 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" });
Comentários
Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o RedirectPermanent método com o segundo parâmetro definido como false.
Esse método converte o objeto que é passado para routeValues um System.Web.Routing.RouteValueDictionary objeto usando o RouteValueDictionary.RouteValueDictionary(Object) construtor . Em RouteCollection.GetVirtualPath seguida, o método é chamado para determinar a URL.
ASP.NET executa o redirecionamento retornando um código de status HTTP 301.
Confira também
Aplica-se a
RedirectToRoutePermanent(Object)
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro de rota.
public:
void RedirectToRoutePermanent(System::Object ^ routeValues);public void RedirectToRoutePermanent (object routeValues);member this.RedirectToRoutePermanent : obj -> unitPublic Sub RedirectToRoutePermanent (routeValues As Object)Parâmetros
- routeValues
- Object
Os valores de parâmetro de rota.
Exceções
Nenhuma rota corresponde aos parâmetros de rotas especificados.
Houve uma tentativa de redirecionamento após o envio dos cabeçalhos HTTP.
Exemplos
O exemplo a seguir mostra como chamar esse método para redirecionar para uma rota que tem parâmetros nomeados productid e category.
Response.RedirectToRoutePermanent(
New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoutePermanent(
new { productid = "1", category = "widgets" });
Comentários
Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o RedirectPermanent(String, Boolean) método com o segundo parâmetro definido como false.
Esse método converte o objeto que é passado para routeValues um System.Web.Routing.RouteValueDictionary objeto usando o RouteValueDictionary.RouteValueDictionary(Object) construtor . Em RouteCollection.GetVirtualPath seguida, o método é chamado para determinar a URL.
ASP.NET executa o redirecionamento retornando um código de status HTTP 301.
Confira também
Aplica-se a
RedirectToRoutePermanent(String)
Executa 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 -> unitPublic Sub RedirectToRoutePermanent (routeName As String)Parâmetros
- routeName
- String
O nome da rota.
Exceções
Nenhuma rota corresponde aos parâmetros de rotas especificados.
Houve uma tentativa de redirecionamento após o envio dos cabeçalhos HTTP.
Exemplos
O exemplo a seguir mostra como chamar esse método para redirecionar para uma rota chamada Products.
Response.RedirectToRoutePermanent("Products")
Response.RedirectToRoutePermanent("Products");
Comentários
Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o RedirectPermanent(String, Boolean) método com o segundo parâmetro definido como false.
Esse método converte o nome da rota que é passado para routeName uma URL usando o RouteCollection.GetVirtualPath método .
ASP.NET executa o redirecionamento retornando um código de status HTTP 301.
Confira também
Aplica-se a
RedirectToRoutePermanent(RouteValueDictionary)
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro 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 -> unitPublic Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)Parâmetros
- routeValues
- RouteValueDictionary
Os valores de parâmetro de rota.
Exceções
Nenhuma rota corresponde aos parâmetros de rotas especificados.
Houve uma tentativa de redirecionamento após o envio dos cabeçalhos HTTP.
Exemplos
O exemplo a seguir mostra como chamar esse método para redirecionar para uma rota que tem parâmetros nomeados productid e category.
Response.RedirectToRoutePermanent(
new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoutePermanent(
new RouteValueDictionary {productId="1", category="widgets"});
Comentários
Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Redirect(String, Boolean) método com o segundo parâmetro definido como false.
Esse método chama o RouteCollection.GetVirtualPath método para determinar a URL.
ASP.NET executa o redirecionamento retornando um código de status HTTP 301.
Confira também
Aplica-se a
RedirectToRoutePermanent(String, RouteValueDictionary)
Executa um redirecionamento permanente de uma URL solicitada para uma nova URL, usando valores de parâmetro 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 -> unitPublic Sub RedirectToRoutePermanent (routeName As String, routeValues As RouteValueDictionary)Parâmetros
- routeName
- String
O nome da rota.
- routeValues
- RouteValueDictionary
Os valores de parâmetro de rota.
Exceções
Nenhuma rota corresponde aos parâmetros de rotas especificados.
Houve uma tentativa de redirecionamento após o envio dos cabeçalhos HTTP.
Exemplos
O exemplo a seguir mostra como chamar esse método para redirecionar para uma rota 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"});
Comentários
Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Redirect(String, Boolean) método com o segundo parâmetro definido como false.
Esse método chama o RouteCollection.GetVirtualPath método para determinar a URL.
ASP.NET executa o redirecionamento retornando um código de status HTTP 301.
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de