RouteTable.Routes Proprietà

Definizione

Spazio dei nomi:

System.Web.Routing

Assembly:

System.Web.dll

Ottiene una raccolta di oggetti derivati dalla 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

Valore della proprietà

RouteCollection

Oggetto che contiene tutte le route nella raccolta.

Esempio

Nell'esempio seguente viene illustrato come aggiungere un Route oggetto alla Routes proprietà .

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

Commenti

Le route sono modelli url usati per l'elaborazione delle richieste e che possono essere usati per costruire gli URL in modo dinamico. La Routes proprietà è una static proprietà (Shared in Visual Basic) che rappresenta tutti gli oggetti utilizzati per specificare la modalità di corrispondenza di una richiesta URL a una classe che gestisce la richiesta. Per specificare una route, aggiungere la definizione di route alla Routes proprietà . In genere, si aggiungono route alla Routes proprietà da un gestore eventi per l'evento Application_Start nel file Global.asax.

Quando un'applicazione ASP.NET gestisce una richiesta, l'applicazione scorre la raccolta di route nella Routes proprietà per trovare la route corrispondente al formato della richiesta URL. L'ordine delle route aggiunte alla proprietà è significativo, perché l'applicazione usa la prima route nella raccolta che corrisponde all'URL Routes .

Vedi anche

• Routing di ASP.NET