HttpResponse.RedirectToRoute Método

Definição

Espaço de Nomes:: System.Web

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Redireciona um pedido para uma nova URL usando valores de parâmetros de rota, um nome de rota, ou ambos.

Sobrecargas

Name	Description
RedirectToRoute(Object)	Redireciona um pedido para uma nova URL usando valores de parâmetros de rota.
RedirectToRoute(String)	Redireciona um pedido para uma nova URL usando um nome de rota.
RedirectToRoute(RouteValueDictionary)	Redireciona um pedido para uma nova URL usando valores de parâmetros de rota.
RedirectToRoute(String, Object)	Redireciona um pedido para uma nova URL usando valores de parâmetros de rota e um nome de rota.
RedirectToRoute(String, RouteValueDictionary)	Redireciona um pedido para uma nova URL usando valores de parâmetros de rota e um nome de rota.

RedirectToRoute(Object)

Redireciona um pedido para uma nova URL usando valores de parâmetros 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 dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota cujos parâmetros são nomeados productid e category.

Response.RedirectToRoute(
  New With {.productid = "1", .category = "widgets"})

Response.RedirectToRoute(
  new { productid = "1", category = "widgets" });

Observações

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

Este método converte o objeto que é passado routeValues num System.Web.Routing.RouteValueDictionary objeto usando o RouteValueDictionary.RouteValueDictionary(Object) construtor. O RouteCollection.GetVirtualPath método é então chamado para determinar a URL.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 302.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoute(String)

Redireciona um pedido 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 especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que se chama Products.

Response.RedirectToRoute("Products")

Response.RedirectToRoute("Products");

Observações

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

Este método converte o nome da rota que é passado routeName para uma URL usando o RouteCollection.GetVirtualPath método.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 302.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoute(RouteValueDictionary)

Redireciona um pedido para uma nova URL usando valores de parâmetros 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 dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota cujos parâmetros são nomeados productid e category.

Response.RedirectToRoute(
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoute(
  (new RouteValueDictionary {productId="1", category="widgets"});

Observações

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

Este método chama o RouteCollection.GetVirtualPath método para determinar a URL.

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 302.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoute(String, Object)

Redireciona um pedido para uma nova URL usando valores de parâmetros 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 dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que é 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" });

Observações

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

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 302.

Ver também

Roteamento ASP.NET

Aplica-se a

RedirectToRoute(String, RouteValueDictionary)

Redireciona um pedido para uma nova URL usando valores de parâmetros 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 dos parâmetros de rota.

Exceções

InvalidOperationException

Nenhuma rota corresponde aos parâmetros especificados.

HttpException

Foi tentada a redirecção depois de os cabeçalhos HTTP terem sido enviados.

Exemplos

O exemplo seguinte mostra como chamar este método para redirecionar para uma rota que é 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"});

Observações

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

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

O ASP.NET realiza o redirecionamento devolvendo um código de estado HTTP 302.

Ver também

Roteamento ASP.NET

Aplica-se a

Comentários

Esta página foi útil?