HttpResponse.RedirectToRoutePermanent Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

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

InvalidOperationException

Nenhuma rota corresponde aos parâmetros de rotas especificados.

HttpException

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

• Roteamento do ASP.NET

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

InvalidOperationException

Nenhuma rota corresponde aos parâmetros de rotas especificados.

HttpException

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

• Roteamento do ASP.NET

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

InvalidOperationException

Nenhuma rota corresponde aos parâmetros de rotas especificados.

HttpException

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

• Roteamento do ASP.NET

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

InvalidOperationException

Nenhuma rota corresponde aos parâmetros de rotas especificados.

HttpException

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

• Roteamento do ASP.NET

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

InvalidOperationException

Nenhuma rota corresponde aos parâmetros de rotas especificados.

HttpException

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

• Roteamento do ASP.NET