Route Classe

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.dll

Fournit des propriétés et des méthodes pour définir un itinéraire et obtenir des informations sur l’itinéraire.

public ref class Route : System::Web::Routing::RouteBase

public class Route : System.Web.Routing.RouteBase

type Route = class
    inherit RouteBase

Public Class Route
Inherits RouteBase

Héritage

Object

RouteBase

Route

Dérivé

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Exemples

L’exemple suivant montre comment créer un Route objet et l’ajouter à la Routes propriété.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

Remarques

La Route classe vous permet de spécifier la façon dont le routage est traité dans une application ASP.NET. Vous créez un Route objet pour chaque modèle d’URL que vous souhaitez mapper à une classe qui peut gérer les requêtes qui correspondent à ce modèle. Vous ajoutez ensuite l’itinéraire à la Routes collection. Lorsque l’application reçoit une demande, ASP.NET le routage effectue une itération dans les itinéraires de la Routes collection pour trouver le premier itinéraire qui correspond au modèle de l’URL.

Définissez la Url propriété sur un modèle d’URL. Le modèle d’URL se compose de segments qui viennent après le nom de l’application dans une requête HTTP. Par exemple, dans l’URL http://www.contoso.com/products/show/beverages, le modèle s’applique à products/show/beverages. Modèle avec trois segments, tels que {controller}/{action}/{id}, correspond à l’URL http://www.contoso.com/products/show/beverages. Chaque segment est délimité par le / caractère. Lorsqu’un segment est placé entre accolades ({ et }), le segment est référencé à un paramètre d’URL. ASP.NET routage récupère la valeur de la requête et l’affecte au paramètre d’URL. Dans l’exemple précédent, le paramètre action d’URL est affecté à la valeur show. Si le segment n’est pas placé entre accolades, la valeur est traitée comme une valeur littérale.

Définissez la Defaults propriété sur un RouteValueDictionary objet qui inclut des valeurs utilisées si un paramètre est manquant dans l’URL ou pour définir des valeurs supplémentaires qui ne sont pas paramétrables dans l’URL. Définissez la Constraints propriété sur un RouteValueDictionary objet qui contient des valeurs qui sont des expressions régulières ou IRouteConstraint des objets. Ces valeurs sont utilisées pour déterminer si une valeur de paramètre est valide.

Constructeurs

Nom	Description
Route(String, IRouteHandler)	Initialise une nouvelle instance de la Route classe à l’aide du modèle d’URL et de la classe de gestionnaire spécifiés.
Route(String, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la Route classe, à l’aide du modèle d’URL spécifié, des valeurs de paramètres par défaut et de la classe de gestionnaire.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la Route classe à l’aide du modèle d’URL spécifié, des valeurs de paramètres par défaut, des contraintes et de la classe de gestionnaire.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la Route classe à l’aide du modèle d’URL spécifié, des valeurs de paramètre par défaut, des contraintes, des valeurs personnalisées et de la classe de gestionnaire.

Propriétés

Nom	Description
Constraints	Obtient ou définit un dictionnaire d’expressions qui spécifient des valeurs valides pour un paramètre d’URL.
DataTokens	Obtient ou définit des valeurs personnalisées transmises au gestionnaire de routage, mais qui ne sont pas utilisées pour déterminer si l’itinéraire correspond à un modèle d’URL.
Defaults	Obtient ou définit les valeurs à utiliser si l’URL ne contient pas tous les paramètres.
RouteExistingFiles	Obtient ou définit une valeur qui indique si ASP.NET routage doit gérer les URL qui correspondent à un fichier existant. (Hérité de RouteBase)
RouteHandler	Obtient ou définit l’objet qui traite les demandes de l’itinéraire.
Url	Obtient ou définit le modèle d’URL de l’itinéraire.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteData(HttpContextBase)	Retourne des informations sur l’itinéraire demandé.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Retourne des informations sur l’URL associée à l’itinéraire.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Détermine si une valeur de paramètre correspond à la contrainte de ce paramètre.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• routage ASP.NET