HttpResponse.RedirectToRoute Méthode

Définition

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

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

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

S’applique à

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

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

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

S’applique à

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

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

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

S’applique à

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

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

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

S’applique à

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

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

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

S’applique à