Route.Url Propriedade

Definição

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Obtém ou define o padrão de URL para a rota.

public:
 property System::String ^ Url { System::String ^ get(); void set(System::String ^ value); };

public string Url { get; set; }

member this.Url : string with get, set

Public Property Url As String

Valor da propriedade

String

O padrão para corresponder a rota a uma URL.

Exceções

ArgumentException

Um dos seguintes:

• O valor começa com ~ ou /.

• O valor contém um caractere ?.

• O parâmetro pega-tudo não é o último.

Exception

Os segmentos de URL não são separados por um delimitador ou uma constante literal.

Exemplos

O exemplo a seguir mostra como definir a Url propriedade no construtor de classe. O padrão contém o valor literal "Category" para o primeiro segmento e parâmetros de URL para os próximos dois segmentos.

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

Quando você atribui um valor à Url propriedade , o / caractere é interpretado como um delimitador quando a URL é analisada. Use chaves ({}) para definir uma variável que é conhecida como um parâmetro de URL. O valor do segmento correspondente na URL é atribuído ao parâmetro url. Todos os valores na Url propriedade que não estão entre chaves são tratados como constantes literais.

O ? caractere não é permitido na Url propriedade . Cada segmento de URL deve ser separado por um delimitador ou constante literal. Você pode usar {{ ou }} como caracteres de escape para um caractere de chave.

Confira também

• Roteamento do ASP.NET