HttpResponse.RedirectToRoutePermanent Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire, un nom d'itinéraire, ou les deux.

Surcharges

RedirectToRoutePermanent(String, Object)	Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et le nom d'itinéraire qui correspondent à la nouvelle URL.
RedirectToRoutePermanent(Object)	Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.
RedirectToRoutePermanent(String)	Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant un nom d'itinéraire.
RedirectToRoutePermanent(RouteValueDictionary)	Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.
RedirectToRoutePermanent(String, RouteValueDictionary)	Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

RedirectToRoutePermanent(String, Object)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et le nom d'itinéraire qui correspondent à la nouvelle URL.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Object ^ routeValues);

public void RedirectToRoutePermanent (string routeName, object routeValues);

member this.RedirectToRoutePermanent : string * obj -> unit

Public Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent("Product",
  New With {.productid = "1", .category = "widgets"})

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

Remarques

Cette méthode est fournie pour faciliter le codage. Il équivaut à appeler la RedirectPermanent méthode avec le deuxième paramètre défini sur false.

Cette méthode convertit l’objet passé à un System.Web.Routing.RouteValueDictionary objet à 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 d’état HTTP 301.

Voir aussi

• Routage ASP.NET

RedirectToRoutePermanent(Object)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

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

public void RedirectToRoutePermanent (object routeValues);

member this.RedirectToRoutePermanent : obj -> unit

Public Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent(
  New With {.productid = "1", .category = "widgets"})

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

Remarques

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

Cette méthode convertit l’objet passé à un System.Web.Routing.RouteValueDictionary objet à 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 d’état HTTP 301.

Voir aussi

• Routage ASP.NET

RedirectToRoutePermanent(String)

Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant un nom d'itinéraire.

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

public void RedirectToRoutePermanent (string routeName);

member this.RedirectToRoutePermanent : string -> unit

Public Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

Remarques

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

Cette méthode convertit le nom de l’itinéraire passé à une URL à routeName l’aide de la RouteCollection.GetVirtualPath méthode.

ASP.NET effectue la redirection en retournant un code d’état HTTP 301.

Voir aussi

• Routage ASP.NET

RedirectToRoutePermanent(RouteValueDictionary)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

public:
 void RedirectToRoutePermanent(System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoutePermanent (System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoutePermanent : System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent(
  new RouteValueDictionary {productId="1", category="widgets"})

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

Remarques

Cette méthode est fournie pour faciliter le codage. Il équivaut à 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 d’état HTTP 301.

Voir aussi

• Routage ASP.NET

RedirectToRoutePermanent(String, RouteValueDictionary)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

public:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoutePermanent (string routeName, System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoutePermanent : string * System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoutePermanent (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 et qui ont des paramètres nommés productid et category.

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

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

Remarques

Cette méthode est fournie pour le codage pratique. Il équivaut à 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 d’état HTTP 301.

Voir aussi

• Routage ASP.NET