RouteTable.Routes Свойство

Определение

Пространство имен:

System.Web.Routing

Сборка:

System.Web.dll

Получает коллекцию объектов, производных от класса 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

Значение свойства

RouteCollection

Объект, содержащий все маршруты в коллекции.

Примеры

В следующем примере показано, как добавить Route объект в Routes свойство .

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

Комментарии

Маршруты — это шаблоны URL-адресов, которые используются для обработки запросов и могут использоваться для динамического создания URL-адресов. Свойство Routes является свойством static (Shared в Visual Basic), которое представляет все объекты, используемые для указания способа сопоставления запроса URL-адреса с классом, обрабатывающим запрос. Чтобы указать маршрут, добавьте определение маршрута в Routes свойство . Как правило, маршруты добавляются в Routes свойство из обработчика событий для Application_Start события в файле Global.asax.

Когда приложение ASP.NET обрабатывает запрос, приложение выполняет итерацию по коллекции маршрутов в свойстве Routes , чтобы найти маршрут, соответствующий формату запроса URL-адреса. Порядок маршрутов, добавляемых в Routes свойство , имеет большое значение, так как приложение использует первый маршрут в коллекции, соответствующий URL-адресу.

См. также раздел

• Маршрутизация ASP.NET