RouteTable.Routes Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.