Route Класс

Определение

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

System.Web.Routing

Сборка:

System.Web.dll

Предоставляет свойства и методы для определения маршрута и получения сведений о маршруте.

public ref class Route : System::Web::Routing::RouteBase

public class Route : System.Web.Routing.RouteBase

type Route = class
    inherit RouteBase

Public Class Route
Inherits RouteBase

Наследование

Object

RouteBase

Route

Производный

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Примеры

В следующем примере показано, 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

Комментарии

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

Задайте для Url свойства шаблон URL-адреса. Шаблон URL-адреса состоит из сегментов, которые идут после имени приложения в HTTP-запросе. Например, в URL-адресе http://www.contoso.com/products/show/beveragesшаблон применяется к products/show/beverages. Шаблон с тремя сегментами, например {controller}/{action}/{id}, соответствует URL-адресу http://www.contoso.com/products/show/beverages. Каждый сегмент разделен символом / . Если сегмент заключен в фигурные скобки ({ и }), сегмент ссылается на параметр URL-адреса. ASP.NET маршрутизация получает значение из запроса и назначает его параметру URL-адреса. В предыдущем примере параметру action URL присваивается значение show. Если сегмент не заключен в фигурные скобки, значение обрабатывается как литеральное значение.

Присвойте Defaults свойству объект , RouteValueDictionary включающий значения, которые используются, если параметр отсутствует в URL-адресе, или для задания дополнительных значений, не параметризованных в URL-адресе. Constraints Задайте для свойства объект , RouteValueDictionary содержащий значения, которые являются регулярными выражениями или IRouteConstraint объектами. Эти значения используются для определения допустимости значения параметра.

Конструкторы

Route(String, IRouteHandler)	Инициализирует новый экземпляр класса Route, используя указанный шаблон URL-адреса и класс-обработчик.
Route(String, RouteValueDictionary, IRouteHandler)	Инициализирует новый экземпляр класса Route, используя указанный шаблон URL-адреса, значения параметров по умолчанию и класс-обработчик.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Инициализирует новый экземпляр класса Route, используя указанный шаблон URL-адреса, значения параметров по умолчанию, ограничения и класс-обработчик.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Инициализирует новый экземпляр класса Route, используя указанный шаблон URL-адреса, значения параметров по умолчанию, ограничения, пользовательские значения и класс обработчика.

Свойства

Constraints	Получает или задает словарь выражений, задающих допустимые значения для параметра URL-адреса.
DataTokens	Возвращает или задает пользовательские значения, передаваемые обработчику маршрута, но не используемые для определения соответствия маршрута шаблону URL-адреса.
Defaults	Получает или задает значения, используемые в случае, если URL-адрес не содержит все параметры.
RouteExistingFiles	Возвращает или задает значение, указывающее, должна ли маршрутизация ASP.NET обрабатывать URL-адреса, соответствующие существующему файлу. (Унаследовано от RouteBase)
RouteHandler	Получает или задает объект, обрабатывающий запросы для маршрута.
Url	Получает или задает шаблон URL-адреса для маршрута.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRouteData(HttpContextBase)	Возвращает сведения о запрошенном маршруте.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Возвращает сведения об URL-адресе, связанном с маршрутом.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Определяет, соответствует ли значение параметра заданному для этого параметра ограничению.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

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