Route Route Route Route Class

Definición

Proporciona propiedades y métodos para definir una ruta y para obtener información sobre la misma.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
Herencia
Derivado

Ejemplos

En el ejemplo siguiente se muestra cómo crear Route un objeto y agregarlo a Routes la propiedad.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

Comentarios

La Route clase le permite especificar cómo se procesa el enrutamiento en una aplicación ASP.net.The Route class enables you to specify how routing is processed in an ASP.NET application. Cree un Route objeto para cada patrón de dirección URL que desee asignar a una clase que pueda controlar las solicitudes que corresponden a ese patrón.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. A continuación, agregue la ruta a Routes la colección.You then add the route to the Routes collection. Cuando la aplicación recibe una solicitud, el enrutamiento de ASP.net recorre en iteración Routes las rutas de la colección para buscar la primera ruta que coincida con el patrón de la dirección 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.

Establezca la Url propiedad en un patrón de dirección URL.Set the Url property to a URL pattern. El patrón de dirección URL se compone de segmentos que van después del nombre de la aplicación en una solicitud HTTP.The URL pattern consists of segments that come after the application name in an HTTP request. Por ejemplo, en la dirección http://www.contoso.com/products/show/beveragesURL, el modelo se products/show/beveragesaplica a.For example, in the URL http://www.contoso.com/products/show/beverages, the pattern applies to products/show/beverages. Un patrón con tres segmentos, como {controller}/{action}/{id}, coincide con la dirección 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. Cada segmento se delimita mediante el / carácter.Each segment is delimited by the / character. Cuando un segmento se incluye entre llaves ({ y }), el segmento se conoce como parámetro de dirección URL.When a segment is enclosed in braces ({ and }), the segment is referred to a URL parameter. El enrutamiento de ASP.NET recupera el valor de la solicitud y lo asigna al parámetro de dirección URL.ASP.NET routing retrieves the value from the request and assigns it to the URL parameter. En el ejemplo anterior, se asigna el action valor showal parámetro URL.In the previous example, the URL parameter action is assigned the value show. Si el segmento no está entre llaves, el valor se trata como un valor literal.If the segment is not enclosed in braces, the value is treated as a literal value.

Establezca la Defaults propiedad en un RouteValueDictionary objeto que incluya valores que se utilizan si falta un parámetro en la dirección URL o para establecer valores adicionales que no están parametrizados en la dirección URL.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. Establezca la Constraints propiedad en un RouteValueDictionary objeto que contenga valores que sean expresiones regulares u IRouteConstraint objetos.Set the Constraints property to a RouteValueDictionary object that contains values that are either regular expressions or IRouteConstraint objects. Estos valores se usan para determinar si un valor de parámetro es válido.These values are used to determine whether a parameter value is valid.

Constructores

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

Inicializa una nueva instancia de la clase Route utilizando el modelo de dirección URL y la clase de controlador especificados.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)

Inicializa una nueva instancia de la clase Route, utilizando el modelo de dirección URL, los valores de parámetro predeterminados y la clase de controlador especificados.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)

Inicializa una nueva instancia de la clase Route, utilizando el modelo de dirección URL, los valores de parámetro predeterminados, las restricciones y la clase de controlador especificados.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)

Inicializa una nueva instancia de la clase Route, utilizando el modelo de dirección URL, los valores de parámetro predeterminados, las restricciones, los valores personalizados y la clase de controlador que se han especificado.Initializes a new instance of the Route class, by using the specified URL pattern, default parameter values, constraints, custom values, and handler class.

Propiedades

Constraints Constraints Constraints Constraints

Obtiene o establece un diccionario de expresiones que especifican los valores válidos para un parámetro de dirección URL.Gets or sets a dictionary of expressions that specify valid values for a URL parameter.

DataTokens DataTokens DataTokens DataTokens

Obtiene o establece los valores personalizados que se pasan al controlador de ruta pero que no se usan para determinar si la ruta coincide con un modelo de dirección 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

Obtiene o establece los valores que se usarán si la dirección URL no contiene todos los parámetros.Gets or sets the values to use if the URL does not contain all the parameters.

RouteExistingFiles RouteExistingFiles RouteExistingFiles RouteExistingFiles

Obtiene o establece un valor que indica si el enrutamiento de ASP.NET debe administrar las direcciones URL que coinciden con un archivo existente.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

Obtiene o establece el objeto que procesa las solicitudes para la ruta.Gets or sets the object that processes requests for the route.

Url Url Url Url

Obtiene o establece el modelo de dirección URL para la ruta.Gets or sets the URL pattern for the route.

Métodos

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Devuelve información sobre la ruta solicitada.Returns information about the requested route.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Devuelve información sobre la dirección URL que está asociada a la ruta.Returns information about the URL that is associated with the route.

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

Crea una copia superficial del objeto Object actual.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)

Determina si un valor de parámetro coincide con la restricción de ese parámetro.Determines whether a parameter value matches the constraint for that parameter.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: