RouteTable.Routes Propriedade

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

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

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 da propriedade

RouteCollection

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

Exemplos

O exemplo a seguir 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

Comentários

As rotas são padrões de URL usados para processar solicitações e que podem ser usados para construir URLs dinamicamente. A Routes propriedade é uma static propriedade (Shared no Visual Basic) que representa todos os objetos usados para especificar como uma solicitação de URL é correspondida a uma classe que manipula a solicitação. Para especificar uma rota, adicione a definição de rota à Routes propriedade . Normalmente, você adiciona rotas à Routes propriedade de um manipulador de eventos para o Application_Start evento no arquivo Global.asax.

Quando um aplicativo ASP.NET manipula uma solicitação, o aplicativo itera por meio da coleção de rotas na Routes propriedade para localizar a rota que corresponde ao formato da solicitação de URL. A ordem das rotas que você adiciona à Routes propriedade é significativa, pois o aplicativo usa a primeira rota na coleção que corresponde à URL.

Confira também

• Roteamento do ASP.NET