Route Clase

Definición

Espacio de nombres:

System.Web.Routing

Ensamblado:

System.Web.dll

Proporciona propiedades y métodos para definir una ruta y para obtener información sobre la ruta.

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

Object

RouteBase

Route

Derivado

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Ejemplos

En el ejemplo siguiente se muestra cómo crear un Route objeto y agregarlo a la Routes propiedad .

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. 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. A continuación, agregue la ruta a la Routes colección. Cuando la aplicación recibe una solicitud, ASP.NET el enrutamiento recorre en iteración las rutas de la Routes colección para buscar la primera ruta que coincida con el patrón de la dirección URL.

Establezca la Url propiedad en un patrón de dirección URL. El patrón de dirección URL consta de segmentos que vienen después del nombre de la aplicación en una solicitud HTTP. Por ejemplo, en la dirección URL http://www.contoso.com/products/show/beverages, el patrón se aplica a 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/beverages. Cada segmento se delimita por el / carácter . Cuando un segmento está entre llaves ({ y }), se hace referencia al segmento a un parámetro de dirección URL. ASP.NET enrutamiento recupera el valor de la solicitud y lo asigna al parámetro URL. En el ejemplo anterior, al parámetro action URL se le asigna el valor show. Si el segmento no está entre llaves, el valor se trata como un valor literal.

Establezca la Defaults propiedad en un RouteValueDictionary objeto que incluya valores que se usan si falta un parámetro de la dirección URL o para establecer valores adicionales que no están parametrizados en la dirección URL. Establezca la Constraints propiedad en un RouteValueDictionary objeto que contenga valores que sean expresiones regulares o IRouteConstraint objetos. Estos valores se usan para determinar si un valor de parámetro es válido.

Constructores

Nombre	Description
Route(String, IRouteHandler)	Inicializa una nueva instancia de la Route clase mediante el patrón de dirección URL y la clase de controlador especificados.
Route(String, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la Route clase utilizando el patrón de dirección URL especificado, los valores de parámetro predeterminados y la clase de controlador.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la Route clase mediante el patrón de dirección URL especificado, los valores de parámetro predeterminados, las restricciones y la clase de controlador especificados.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la Route clase mediante el patrón de dirección URL especificado, los valores de parámetro predeterminados, las restricciones, los valores personalizados y la clase de controlador.

Propiedades

Nombre	Description
Constraints	Obtiene o establece un diccionario de expresiones que especifican valores válidos para un parámetro de dirección URL.
DataTokens	Obtiene o establece valores personalizados que se pasan al controlador de ruta, pero que no se usan para determinar si la ruta coincide con un patrón de dirección URL.
Defaults	Obtiene o establece los valores que se van a usar si la dirección URL no contiene todos los parámetros.
RouteExistingFiles	Obtiene o establece un valor que indica si ASP.NET enrutamiento debe controlar las direcciones URL que coinciden con un archivo existente. (Heredado de RouteBase)
RouteHandler	Obtiene o establece el objeto que procesa las solicitudes de la ruta.
Url	Obtiene o establece el patrón de dirección URL de la ruta.

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetRouteData(HttpContextBase)	Devuelve información sobre la ruta solicitada.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Devuelve información sobre la dirección URL asociada a la ruta.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Determina si un valor de parámetro coincide con la restricción de ese parámetro.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• enrutamiento de ASP.NET