RouteTable.Routes Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling objecten op die zijn afgeleid van de RouteBase klasse.
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
Waarde van eigenschap
Een object dat alle routes in de verzameling bevat.
Voorbeelden
In het volgende voorbeeld ziet u hoe u een Route object toevoegt aan de Routes eigenschap.
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
Opmerkingen
Routes zijn URL-patronen die worden gebruikt voor het verwerken van aanvragen en die kunnen worden gebruikt om URL's dynamisch samen te stellen. De eigenschap Routes is een eigenschap static (Shared in Visual Basic) die alle objecten vertegenwoordigt die worden gebruikt om op te geven hoe een URL-aanvraag overeenkomt met een klasse die de aanvraag verwerkt. Als u een route wilt opgeven, voegt u de routedefinitie toe aan de Routes eigenschap. Normaal gesproken voegt u routes toe aan de Routes eigenschap vanuit een gebeurtenis-handler voor de Application_Start gebeurtenis in het bestand Global.asax.
Wanneer een ASP.NET toepassing een aanvraag verwerkt, doorloopt de toepassing de verzameling routes in de eigenschap Routes om de route te vinden die overeenkomt met de indeling van de URL-aanvraag. De volgorde van de routes die u aan de Routes eigenschap toevoegt, is belangrijk, omdat de toepassing gebruikmaakt van de eerste route in de verzameling die overeenkomt met de URL.