Route Classe

Definição

Espaço de Nomes:

System.Web.Routing

Assemblagem:

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

Observações

A classe Route permite-lhe especificar como o encaminhamento é processado numa aplicação ASP.NET. Crias um Route objeto para cada padrão URL que queres mapear para uma classe que consiga lidar com pedidos que correspondam a esse padrão. Depois adiciona-se a rota à Routes coleção. Quando a aplicação recebe um pedido, ASP.NET roteamento percorre as rotas na coleção Routes para encontrar a primeira rota que corresponda ao padrão da URL.

Defina a Url propriedade para um padrão URL. O padrão URL consiste em segmentos que surgem após o nome da aplicação num pedido HTTP. Por exemplo, na URL http://www.contoso.com/products/show/beverages, o padrão aplica-se 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 / carácter. Quando um segmento está incluído em colchetes ({ e }), o segmento é referido a um parâmetro URL. O encaminhamento ASP.NET recupera o valor do pedido e atribui-o ao parâmetro URL. No exemplo anterior, o parâmetro action URL é atribuído ao valor show. Se o segmento não estiver envolto em colchetes, o valor é tratado como um valor literal.

Defina a Defaults propriedade para um RouteValueDictionary objeto que inclua valores usados se um parâmetro estiver em falta na URL ou para definir valores adicionais que não estão parametrizados na URL. Defina a Constraints propriedade para um RouteValueDictionary objeto que contenha valores que são expressões regulares ou IRouteConstraint objetos. Estes valores são usados para determinar se um valor de parâmetro é válido.

Construtores

Name	Description
Route(String, IRouteHandler)	Inicializa uma nova instância da Route classe, usando o padrão URL especificado e a classe handler.
Route(String, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da Route classe, usando o padrão de URL especificado, valores de parâmetros padrão e classe handler.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da Route classe, utilizando o padrão URL especificado, valores de parâmetros padrão, restrições e classe handler.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializa uma nova instância da Route classe, utilizando o padrão de URL especificado, valores de parâmetros predefinidos, restrições, valores personalizados e classe handler.

Propriedades

Name	Description
Constraints	Obtém ou define um dicionário de expressões que especificam valores válidos para um parâmetro URL.
DataTokens	Obtém ou define valores personalizados que são passados ao gestor 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 usar se a URL não contiver todos os parâmetros.
RouteExistingFiles	Recebe ou define um valor que indica se o encaminhamento ASP.NET deve tratar URLs que correspondem a um ficheiro existente. (Herdado de RouteBase)
RouteHandler	Obtém ou define o objeto que processa pedidos para a rota.
Url	Obtém ou define o padrão de URL para a rota.

Métodos

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

Ver também

• Roteamento ASP.NET