Route Класс

Ссылка

Определение

Пространство имен:: System.Web.Routing

Сборка:: System.Web.Routing.dll

Сборка:: 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