Partilhar via


HttpResponse.RedirectToRoutePermanent Método

Definição

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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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