Compartilhar via


HttpResponse.RedirectToRoute Método

Definição

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota, um nome de rota ou ambos.

Sobrecargas

RedirectToRoute(Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

RedirectToRoute(String)

Redireciona uma solicitação para uma nova URL usando um nome de rota.

RedirectToRoute(RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

RedirectToRoute(String, Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

RedirectToRoute(String, RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

RedirectToRoute(Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

public:
 void RedirectToRoute(System::Object ^ routeValues);
public void RedirectToRoute (object routeValues);
member this.RedirectToRoute : obj -> unit
Public Sub RedirectToRoute (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.RedirectToRoute(
  New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoute(
  new { productid = "1", category = "widgets" });

Comentários

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

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 302.

Confira também

Aplica-se a

RedirectToRoute(String)

Redireciona uma solicitação para uma nova URL usando um nome de rota.

public:
 void RedirectToRoute(System::String ^ routeName);
public void RedirectToRoute (string routeName);
member this.RedirectToRoute : string -> unit
Public Sub RedirectToRoute (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.RedirectToRoute("Products")
Response.RedirectToRoute("Products");

Comentários

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

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 302.

Confira também

Aplica-se a

RedirectToRoute(RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota.

public:
 void RedirectToRoute(System::Web::Routing::RouteValueDictionary ^ routeValues);
public void RedirectToRoute (System.Web.Routing.RouteValueDictionary routeValues);
member this.RedirectToRoute : System.Web.Routing.RouteValueDictionary -> unit
Public Sub RedirectToRoute (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.RedirectToRoute(
  new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoute(
  (new RouteValueDictionary {productId="1", category="widgets"});

Comentários

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

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 302.

Confira também

Aplica-se a

RedirectToRoute(String, Object)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

public:
 void RedirectToRoute(System::String ^ routeName, System::Object ^ routeValues);
public void RedirectToRoute (string routeName, object routeValues);
member this.RedirectToRoute : string * obj -> unit
Public Sub RedirectToRoute (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.RedirectToRoute("Product",
  New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoute("Product",
  new { productid = "1", category = "widgets" });

Comentários

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

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 302.

Confira também

Aplica-se a

RedirectToRoute(String, RouteValueDictionary)

Redireciona uma solicitação para uma nova URL usando valores de parâmetro de rota e um nome de rota.

public:
 void RedirectToRoute(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);
public void RedirectToRoute (string routeName, System.Web.Routing.RouteValueDictionary routeValues);
member this.RedirectToRoute : string * System.Web.Routing.RouteValueDictionary -> unit
Public Sub RedirectToRoute (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.RedirectToRoute("Product",
  new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoute("Product",
  (new RouteValueDictionary {productId="1", category="widgets"});

Comentários

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

O RouteCollection.GetVirtualPath método é chamado para determinar a URL.

ASP.NET executa o redirecionamento retornando um código de status HTTP 302.

Confira também

Aplica-se a