RouteTable.Routes Propriété
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.
Obtient une collection d’objets dérivés de la classe RouteBase.
public:
static property System::Web::Routing::RouteCollection ^ Routes { System::Web::Routing::RouteCollection ^ get(); };
public static System.Web.Routing.RouteCollection Routes { get; }
static member Routes : System.Web.Routing.RouteCollection
Public Shared ReadOnly Property Routes As RouteCollection
Valeur de propriété
Objet qui contient tous les itinéraires de la collection.
Exemples
L’exemple suivant montre comment ajouter un Route objet à 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
Les itinéraires sont des modèles d’URL qui sont utilisés pour traiter les demandes et qui peuvent être utilisés pour construire des URL de manière dynamique. La Routes propriété est une static
propriété (Shared
en Visual Basic) qui représente tous les objets utilisés pour spécifier la façon dont une demande d’URL est mise en correspondance avec une classe qui gère la requête. Pour spécifier un itinéraire, vous ajoutez la définition de route à la Routes propriété . En règle générale, vous ajoutez des itinéraires à la Routes propriété à partir d’un gestionnaire d’événements pour l’événement Application_Start
dans le fichier Global.asax.
Lorsqu’une application ASP.NET gère une demande, l’application effectue une itération au sein de la collection d’itinéraires dans la Routes propriété pour trouver l’itinéraire qui correspond au format de la demande d’URL. L’ordre des itinéraires que vous ajoutez à la Routes propriété est significatif, car l’application utilise le premier itinéraire de la collection qui correspond à l’URL.