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-адреса. В предыдущем примере параметр URL-адреса action присваивается значению show. Если сегмент не заключен в фигурные скобки, значение рассматривается как литеральное значение.

Задайте свойству Defaults объект RouteValueDictionary , содержащий значения, которые используются, если параметр отсутствует из URL-адреса или задать дополнительные значения, которые не параметризованы в URL-адресе. Задайте свойству ConstraintsRouteValueDictionary объект, содержащий значения, которые являются регулярными выражениями или 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 маршрутизация