Route Clase

Definición

Espacio de nombres:

System.Web.Routing

Ensamblado:

System.Web.Routing.dll

Ensamblado:

System.Web.dll

Proporciona propiedades y métodos para definir una ruta y para obtener información acerca de 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 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 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 está delimitado por el / carácter . Cuando un segmento se incluye 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 contiene valores que son expresiones regulares u IRouteConstraint objetos. Estos valores se usan para determinar si un valor de parámetro es válido.

Constructores

Route(String, IRouteHandler)	Inicializa una nueva instancia de la clase Route con el patrón de dirección URL y la clase de controlador especificados.
Route(String, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la clase Route con el modelo de dirección URL, los valores de parámetros predeterminados y la clase de controlador especificados.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la clase Route con el patrón de URL, los valores de parámetros predeterminados y la clase de controlador especificados.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa una nueva instancia de la clase Route con el patrón de URL, los valores de parámetros predeterminados, las restricciones, los valores personalizados y la clase de controlador especificados.

Propiedades

Constraints	Obtiene o establece un diccionario de expresiones que especifican los valores válidos para un parámetro de dirección URL.
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 patrón de dirección URL.
Defaults	Obtiene o establece los valores que se usarán si la dirección URL no contiene todos los parámetros.
RouteExistingFiles	Obtiene o establece un valor que indica si el enrutamiento de ASP.NET debe controlar las direcciones URL que coinciden con un archivo existente. (Heredado de RouteBase)
RouteHandler	Obtiene o establece el objeto que procesa solicitudes de la ruta.
Url	Obtiene o establece el patrón de la dirección URL de la ruta.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la 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 que está asociada a la ruta.
MemberwiseClone()	Crea una copia superficial del Object actual. (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