RouteTable.Routes Vlastnost

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.dll

Získá kolekci objektů, které jsou odvozeny RouteBase z třídy .

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

Hodnota vlastnosti

RouteCollection

Objekt, který obsahuje všechny trasy v kolekci.

Příklady

Následující příklad ukazuje, jak přidat Route objekt do Routes vlastnosti .

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

Poznámky

Trasy jsou vzory adres URL, které se používají ke zpracování požadavků a které lze použít k dynamickému vytváření adres URL. Vlastnost Routes je static vlastnost (Shared v jazyce Visual Basic), která představuje všechny objekty, které se používají k určení způsobu, jakým je požadavek url spárován s třídou, která požadavek zpracovává. Pokud chcete určit trasu, přidejte definici trasy do Routes vlastnosti . Obvykle se trasy do Routes vlastnosti přidávají z obslužné rutiny události v Application_Start souboru Global.asax.

Když ASP.NET aplikace zpracuje požadavek, aplikace iteruje kolekci tras ve Routes vlastnosti a najde trasu, která odpovídá formátu požadavku adresy URL. Pořadí tras, které přidáte do Routes vlastnosti, je významné, protože aplikace používá první trasu v kolekci, která odpovídá adrese URL.

Viz také

• směrování ASP.NET