HttpResponse.RedirectToRoute Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

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

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

• Roteamento do ASP.NET

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

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

• Roteamento do ASP.NET

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

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

• Roteamento do ASP.NET

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

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

• Roteamento do ASP.NET

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

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

• Roteamento do ASP.NET