Route.Url Propriedade

Definição

Espaço de Nomes:
System.Web.Routing
Assemblagem:
System.Web.Routing.dll
Assemblagem:
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 de Propriedade

String

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

Exceções

ArgumentException

Qualquer um dos seguintes:

  • O valor começa por ~ ou /.

  • O valor contém um ? carácter.

  • O parâmetro genérico não é o último.

Exception

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

Exemplos

O exemplo seguinte mostra como definir a Url propriedade no construtor de classes. O padrão contém o valor literal "Categoria" para o primeiro segmento e parâmetros URL para os dois segmentos seguintes.

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

Quando atribui um valor à Url propriedade, o / carácter é interpretado como um delimitador quando a URL é analisada. Use colchetes ({}) para definir uma variável que é referida como parâmetro URL. O valor do segmento correspondente na URL é atribuído ao parâmetro URL. Quaisquer valores na Url propriedade que não estejam incluídos entre colchetes são tratados como constantes literais.

A ? personagem não é permitida na Url propriedade. Cada segmento URL deve ser separado por um delimitador ou por uma constante literal. Podes usar {{ ou }} como personagens de escape para uma personagem de apoio.

Aplica-se a

Ver também