Linguagem

RouteTable.Routes Propriedade

Definição

Obtém uma coleção de objetos que derivam da RouteBase classe.

public:
 static property System::Web::Routing::RouteCollection ^ Routes { System::Web::Routing::RouteCollection ^ get(); };
public static System.Web.Routing.RouteCollection Routes { get; }
static member Routes : System.Web.Routing.RouteCollection
Public Shared ReadOnly Property Routes As RouteCollection

Valor de Propriedade

Um objeto que contém todas as rotas da coleção.

Exemplos

O exemplo seguinte mostra como adicionar um Route objeto à 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

As rotas são padrões de URL usados para processar pedidos e que podem ser usados para construir URLs dinamicamente. A propriedade Routes é uma propriedade static (Shared em Visual Basic) que representa todos os objetos usados para especificar como um pedido URL é correspondido a uma classe que gere o pedido. Para especificar uma rota, adiciona-se a definição da rota à Routes propriedade. Normalmente, adiciona-se rotas à Routes propriedade a partir de um gestor de eventos para o Application_Start evento no ficheiro Global.asax.

Quando uma aplicação ASP.NET lida com um pedido, a aplicação percorre a coleção de rotas na propriedade Routes para encontrar a rota que corresponde ao formato do pedido de URL. A ordem das rotas que adicionas à Routes propriedade é significativa, porque a aplicação usa a primeira rota da coleção que corresponde ao URL.

Aplica-se a

Ver também