HttpResponse.RedirectToRoute Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Redirige une requête vers une nouvelle URL en utilisant des valeurs de paramètres d'itinéraires, un nom d'itinéraire, ou les deux.

Surcharges

RedirectToRoute(Object)	Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.
RedirectToRoute(String)	Redirige une requête vers une nouvelle URL en utilisant un nom d'itinéraire.
RedirectToRoute(RouteValueDictionary)	Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.
RedirectToRoute(String, Object)	Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.
RedirectToRoute(String, RouteValueDictionary)	Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

RedirectToRoute(Object)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

public:
 void RedirectToRoute(System::Object ^ routeValues);

public void RedirectToRoute (object routeValues);

member this.RedirectToRoute : obj -> unit

Public Sub RedirectToRoute (routeValues As Object)

Paramètres

routeValues

Object

Valeurs des paramètres d'itinéraire.

Exceptions

InvalidOperationException

Aucun itinéraire ne correspond aux paramètres d'itinéraire spécifiés.

HttpException

Une tentative de redirection a eu lieu après l'envoi des en-têtes HTTP.

Exemples

L’exemple suivant montre comment appeler cette méthode pour rediriger vers un itinéraire qui a des paramètres nommés productid et category.

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

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Redirect(String, Boolean) méthode avec le deuxième paramètre défini sur false.

Cette méthode convertit l’objet qui est passé en objet System.Web.Routing.RouteValueDictionary à routeValues l’aide du RouteValueDictionary.RouteValueDictionary(Object) constructeur . La RouteCollection.GetVirtualPath méthode est ensuite appelée pour déterminer l’URL.

ASP.NET effectue la redirection en retournant un code de status HTTP 302.

Voir aussi

• Routage ASP.NET

RedirectToRoute(String)

Redirige une requête vers une nouvelle URL en utilisant un nom d'itinéraire.

public:
 void RedirectToRoute(System::String ^ routeName);

public void RedirectToRoute (string routeName);

member this.RedirectToRoute : string -> unit

Public Sub RedirectToRoute (routeName As String)

Paramètres

routeName

String

Nom de l'itinéraire.

Exceptions

InvalidOperationException

Aucun itinéraire ne correspond aux paramètres d'itinéraire spécifiés.

HttpException

Une tentative de redirection a eu lieu après l'envoi des en-têtes HTTP.

Exemples

L’exemple suivant montre comment appeler cette méthode pour rediriger vers un itinéraire nommé Products.

Response.RedirectToRoute("Products")

Response.RedirectToRoute("Products");

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Redirect(String, Boolean) méthode avec le deuxième paramètre défini sur false.

Cette méthode convertit le nom de route qui est passé en URL à routeName l’aide de la RouteCollection.GetVirtualPath méthode .

ASP.NET effectue la redirection en retournant un code de status HTTP 302.

Voir aussi

• Routage ASP.NET

RedirectToRoute(RouteValueDictionary)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

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)

Paramètres

routeValues

RouteValueDictionary

Valeurs des paramètres d'itinéraire.

Exceptions

InvalidOperationException

Aucun itinéraire ne correspond aux paramètres d'itinéraire spécifiés.

HttpException

Une tentative de redirection a eu lieu après l'envoi des en-têtes HTTP.

Exemples

L’exemple suivant montre comment appeler cette méthode pour rediriger vers un itinéraire qui a des paramètres nommés productid et category.

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

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Redirect(String, Boolean) méthode avec le deuxième paramètre défini sur false.

Cette méthode appelle la RouteCollection.GetVirtualPath méthode pour déterminer l’URL.

ASP.NET effectue la redirection en retournant un code de status HTTP 302.

Voir aussi

• Routage ASP.NET

RedirectToRoute(String, Object)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

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)

Paramètres

routeName

String

Nom de l'itinéraire.

routeValues

Object

Valeurs des paramètres d'itinéraire.

Exceptions

InvalidOperationException

Aucun itinéraire ne correspond aux paramètres d'itinéraire spécifiés.

HttpException

Une tentative de redirection a eu lieu après l'envoi des en-têtes HTTP.

Exemples

L’exemple suivant montre comment appeler cette méthode pour rediriger vers un itinéraire nommé Product et qui a des paramètres nommés productid et category.

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

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Redirect(String, Boolean) méthode avec le deuxième paramètre défini sur false.

Cette méthode convertit l’objet qui est passé en objet System.Web.Routing.RouteValueDictionary à routeValues l’aide du RouteValueDictionary.RouteValueDictionary(Object) constructeur . La RouteCollection.GetVirtualPath méthode est ensuite appelée pour déterminer l’URL.

ASP.NET effectue la redirection en retournant un code de status HTTP 302.

Voir aussi

• Routage ASP.NET

RedirectToRoute(String, RouteValueDictionary)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

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)

Paramètres

routeName

String

Nom de l'itinéraire.

routeValues

RouteValueDictionary

Valeurs des paramètres d'itinéraire.

Exceptions

InvalidOperationException

Aucun itinéraire ne correspond aux paramètres d'itinéraire spécifiés.

HttpException

Une tentative de redirection a eu lieu après l'envoi des en-têtes HTTP.

Exemples

L’exemple suivant montre comment appeler cette méthode pour rediriger vers un itinéraire nommé Product et qui a des paramètres nommés productid et category.

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

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Redirect(String, Boolean) méthode avec le deuxième paramètre défini sur false.

La RouteCollection.GetVirtualPath méthode est appelée pour déterminer l’URL.

ASP.NET effectue la redirection en retournant un code de status HTTP 302.

Voir aussi

• Routage ASP.NET