HttpResponse.RedirectToRoutePermanent Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
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.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. Cela revient à appeler la RedirectPermanent 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 301.
Voir aussi
S’applique à
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 -> unitPublic Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent(
New With {.productid = "1", .category = "widgets"})
Response.RedirectToRoutePermanent(
new { productid = "1", category = "widgets" });
Remarques
Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la RedirectPermanent(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 301.
Voir aussi
S’applique à
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 -> unitPublic Sub RedirectToRoutePermanent (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.RedirectToRoutePermanent("Products")
Response.RedirectToRoutePermanent("Products");
Remarques
Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la RedirectPermanent(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 301.
Voir aussi
S’applique à
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 -> unitPublic Sub RedirectToRoutePermanent (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.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. 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 301.
Voir aussi
S’applique à
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 -> unitPublic 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
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.RedirectToRoutePermanent("Product",
new RouteValueDictionary {productId="1", category="widgets"})
Response.RedirectToRoutePermanent("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.
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 301.
