Route Classe

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.Routing.dll

Assembly:

System.Web.dll

Fornece propriedades e métodos para definir uma rota e para obter informações sobre ela.

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

Herança

Object

RouteBase

Route

Derivado

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Exemplos

O exemplo a seguir mostra como criar um Route objeto e adicioná-lo à Routes propriedade.

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

Comentários

A Route classe permite que você especifique como o roteamento é processado em um aplicativo ASP.NET. Você cria um Route objeto para cada padrão de URL que deseja mapear para uma classe que pode lidar com solicitações que correspondem a esse padrão. Em seguida, adicione a rota à Routes coleção. Quando o aplicativo recebe uma solicitação, ASP.NET roteamento itera pelas rotas da Routes coleção para localizar a primeira rota que corresponde ao padrão da URL.

Defina a Url propriedade como um padrão de URL. O padrão de URL consiste em segmentos que vêm após o nome do aplicativo em uma solicitação HTTP. Por exemplo, na URL http://www.contoso.com/products/show/beverages, o padrão se aplica a products/show/beverages. Um padrão com três segmentos, como {controller}/{action}/{id}, corresponde à URL http://www.contoso.com/products/show/beverages. Cada segmento é delimitado pelo / caractere. Quando um segmento é colocado entre chaves ({ e }), o segmento é referenciado a um parâmetro de URL. ASP.NET roteamento recupera o valor da solicitação e o atribui ao parâmetro de URL. No exemplo anterior, o parâmetro action de URL recebe o valor show. Se o segmento não estiver entre chaves, o valor será tratado como um valor literal.

Defina a Defaults propriedade como um RouteValueDictionary objeto que inclui valores que são usados se um parâmetro estiver ausente da URL ou para definir valores adicionais que não são parametrizados na URL. Defina a Constraints propriedade como um RouteValueDictionary objeto que contém valores que são expressões regulares ou IRouteConstraint objetos. Esses valores são usados para determinar se um valor de parâmetro é válido.

Construtores

Route(String, IRouteHandler)	Inicializa uma nova instância da classe Route usando o padrão de URL e a classe de manipulador especificados.
Route(String, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da classe Route usando o padrão de URL, a classe de manipulador e os valores de parâmetro padrão especificados.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da classe Route usando o padrão de URL, as restrições, a classe de manipulador e os valores de parâmetro padrão especificados.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da classe Route usando o padrão de URL, os valores de parâmetro padrão, as restrições, a classe de manipulador e os valores personalizados especificados.

Propriedades

Constraints	Obtém ou define um dicionário de expressões que especificam os valores válidos para um parâmetro de URL.
DataTokens	Obtém ou define valores personalizados que são passados para o manipulador de rotas, mas que não são usados para determinar se a rota corresponde a um padrão de URL.
Defaults	Obtém ou define os valores a serem usados se a URL não contiver todos os parâmetros.
RouteExistingFiles	Obtém ou define um valor que indica se o roteamento do ASP.NET deve tratar URLs que correspondam a um arquivo existente. (Herdado de RouteBase)
RouteHandler	Obtém ou define o objeto que processa as solicitações para a rota.
Url	Obtém ou define o padrão de URL para a rota.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteData(HttpContextBase)	Retorna informações sobre a rota solicitada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Retorna informações sobre a URL que está associada com a rota.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Determina se um valor de parâmetro corresponde à restrição para esse parâmetro.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Roteamento ASP.NET