Route Classe

Référence

Définition

Espace de noms:: System.Web.Routing

Assembly:: System.Web.Routing.dll

Assembly:: System.Web.dll

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.

Fournit des propriétés et des méthodes pour définir un itinéraire et pour 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 requête, ASP.NET le routage effectue une itération dans les itinéraires de la Routes collection pour rechercher 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. Un 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

Route(String, IRouteHandler)	Initialise une nouvelle instance de la classe Route en utilisant le modèle d’URL spécifié et la classe de gestionnaire.
Route(String, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la classe Route en utilisant le modèle d’URL spécifié, les valeurs de paramètres par défaut et la classe de gestionnaire.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la classe Route en utilisant le modèle d’URL, les valeurs de paramètres par défaut, les contraintes et la classe de gestionnaire spécifiés.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Initialise une nouvelle instance de la classe Route en utilisant le modèle d’URL, les valeurs des paramètres par défaut, les contraintes, les valeurs personnalisées et la classe de gestionnaire spécifiés.

Propriétés

Constraints	Obtient ou définit un dictionnaire des expressions qui spécifient les valeurs valides d’un paramètre d’URL.
DataTokens	Obtient ou définit des valeurs personnalisées qui sont passées au gestionnaire d’itinéraires, 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 le routage ASP.NET doit gérer des URL qui correspondent à un fichier existant. (Hérité de RouteBase)
RouteHandler	Obtient ou définit l’objet qui traite les requêtes pour la route.
Url	Obtient ou définit le modèle d’URL pour la route.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetRouteData(HttpContextBase)	Retourne des informations sur l'itinéraire demandé.
GetType()	Obtient le 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 Object actuel. (Hérité de Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Détermine si une valeur de paramètre correspond à la contrainte pour ce paramètre.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Voir aussi

Routage ASP.NET