Route Route Route Route Class

Определение

Предоставляет свойства и методы для определения маршрута и получения сведений о маршруте.Provides properties and methods for defining a route and for obtaining information about the route.

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
Наследование
Производный

Примеры

В следующем примере показано, как создать Route объект и добавить его Routes в свойство.The following example shows how to create a Route object and add it to the Routes property.

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.The Route class enables you to specify how routing is processed in an ASP.NET application. Вы создаете Route объект для каждого шаблона URL-адреса, который необходимо сопоставлять с классом, который может выполнять запросы, соответствующие этому шаблону.You create a Route object for each URL pattern that you want to map to a class that can handle requests that correspond to that pattern. Затем добавьте маршрут в Routes коллекцию.You then add the route to the Routes collection. Когда приложение получает запрос, ASP.NET маршрутизация проходит по маршрутам в Routes коллекции, чтобы найти первый маршрут, соответствующий шаблону URL-адреса.When the application receives a request, ASP.NET routing iterates through the routes in the Routes collection to find the first route that matches the pattern of the URL.

Задайте для Url свойства шаблон URL-адреса.Set the Url property to a URL pattern. Шаблон URL-адреса состоит из сегментов, которые поступают после имени приложения в HTTP-запросе.The URL pattern consists of segments that come after the application name in an HTTP request. Например, в URL-адресе http://www.contoso.com/products/show/beveragesшаблон применяется к. products/show/beveragesFor example, in the URL http://www.contoso.com/products/show/beverages, the pattern applies to products/show/beverages. Шаблон с тремя сегментами, например {controller}/{action}/{id}, соответствует URL-адресу. http://www.contoso.com/products/show/beveragesA pattern with three segments, such as {controller}/{action}/{id}, matches the URL http://www.contoso.com/products/show/beverages. Каждый сегмент отделяется / символом.Each segment is delimited by the / character. Если сегмент заключен в фигурные скобки ({ и }), этот сегмент называется параметром URL-адреса.When a segment is enclosed in braces ({ and }), the segment is referred to a URL parameter. ASP.NET маршрутизация получает значение из запроса и присваивает его параметру URL-адреса.ASP.NET routing retrieves the value from the request and assigns it to the URL parameter. В предыдущем примере параметру action URL присваивается значение. showIn the previous example, the URL parameter action is assigned the value show. Если сегмент не заключен в фигурные скобки, значение рассматривается как литеральное значение.If the segment is not enclosed in braces, the value is treated as a literal value.

Defaults Задайте длясвойстваобъект,которыйсодержитзначения,используемые,есливURL-адресеотсутствуетпараметр,илидлязаданиядополнительныхзначений,которыенепараметризованывURLRouteValueDictionary -адресе.Set the Defaults property to a RouteValueDictionary object that includes values that are used if a parameter is missing from the URL or to set additional values that are not parameterized in the URL. Задайте для свойства объект, содержащий значения, которые являются либо регулярными выражениями IRouteConstraint , либо объектами. RouteValueDictionary ConstraintsSet the Constraints property to a RouteValueDictionary object that contains values that are either regular expressions or IRouteConstraint objects. Эти значения используются, чтобы определить, является ли допустимым значение параметра.These values are used to determine whether a parameter value is valid.

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

Route(String, IRouteHandler) Route(String, IRouteHandler) Route(String, IRouteHandler) Route(String, IRouteHandler)

Инициализирует новый экземпляр класса Route, используя заданный шаблон URL-адреса и класс-обработчик.Initializes a new instance of the Route class, by using the specified URL pattern and handler class.

Route(String, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, IRouteHandler)

Инициализирует новый экземпляр класса Route, используя заданный шаблон URL-адреса, значения параметров по умолчанию и класс-обработчик.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, and handler class.

Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Инициализирует новый экземпляр класса Route, используя заданный шаблон URL-адреса, значения параметров по умолчанию, ограничения и класс-обработчик.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, and handler class.

Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler) Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Инициализирует новый экземпляр класса Route, используя заданный шаблон URL-адреса, значения параметров по умолчанию, ограничения, пользовательские значения и класс-обработчик.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, custom values, and handler class.

Свойства

Constraints Constraints Constraints Constraints

Получает или задает словарь выражений, задающих допустимые значения для параметра URL-адреса.Gets or sets a dictionary of expressions that specify valid values for a URL parameter.

DataTokens DataTokens DataTokens DataTokens

Возвращает или задает пользовательские значения, передаваемые обработчику маршрута, но не используемые для определения соответствия маршрута заданному шаблону URL-адреса.Gets or sets custom values that are passed to the route handler, but which are not used to determine whether the route matches a URL pattern.

Defaults Defaults Defaults Defaults

Возвращает или задает значения для использования в случае, если URL-адрес не содержит всех параметров.Gets or sets the values to use if the URL does not contain all the parameters.

RouteExistingFiles RouteExistingFiles RouteExistingFiles RouteExistingFiles

Возвращает или задает значение, указывающее, должна ли ASP.NET обрабатывать URL-адреса, соответствующие имеющемуся файлу.Gets or sets a value that indicates whether ASP.NET routing should handle URLs that match an existing file.

(Inherited from RouteBase)
RouteHandler RouteHandler RouteHandler RouteHandler

Возвращает или задает объект, обрабатывающий запросы для маршрута.Gets or sets the object that processes requests for the route.

Url Url Url Url

Возвращает или задает шаблон URL-адреса для маршрута.Gets or sets the URL pattern for the route.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetRouteData(HttpContextBase) GetRouteData(HttpContextBase) GetRouteData(HttpContextBase) GetRouteData(HttpContextBase)

Возвращает сведения о запрошенном маршруте.Returns information about the requested route.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetVirtualPath(RequestContext, RouteValueDictionary) GetVirtualPath(RequestContext, RouteValueDictionary) GetVirtualPath(RequestContext, RouteValueDictionary) GetVirtualPath(RequestContext, RouteValueDictionary)

Возвращает сведения об URL-адресе, связанном с маршрутом.Returns information about the URL that is associated with the route.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection) ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection) ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection) ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)

Определяет, соответствует ли значение параметра заданному для этого параметра ограничению.Determines whether a parameter value matches the constraint for that parameter.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к

Дополнительно