Route Classe

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

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

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 na 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 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

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

Propriedades

Nome	Description
Constraints	Obtém ou define um dicionário de expressões que especificam 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 ASP.NET roteamento deve manipular URLs que correspondem a um arquivo existente. (Herdado de RouteBase)
RouteHandler	Obtém ou define o objeto que processa solicitações para a rota.
Url	Obtém ou define o padrão de URL da rota.

Métodos

Nome	Description
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 associada à rota.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (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 de ASP.NET