Route.Url Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.Routing
Assembly:
System.Web.Routing.dll
Assembly:
System.Web.dll

Ottiene o imposta il modello di URL per la route.

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

Valore della proprietà

String

Modello per mettere in corrispondenza la route con un URL.

Eccezioni

ArgumentException

Uno dei casi seguenti:

  • Il valore inizia con ~ o /.

  • Il valore contiene un ? carattere.

  • Il parametro catch-all non è ultimo.

Exception

I segmenti di URL non sono separati da un delimitatore o una costante letterale.

Esempio

Nell'esempio seguente viene illustrato come impostare la Url proprietà nel costruttore della classe . Il modello contiene il valore letterale "Category" per il primo segmento e i parametri URL per i due segmenti successivi.

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

Commenti

Quando si assegna un valore alla Url proprietà, il / carattere viene interpretato come delimitatore quando l'URL viene analizzato. Usare le parentesi graffe ({}) per definire una variabile denominata parametro URL. Il valore del segmento corrispondente nell'URL viene assegnato al parametro URL. Tutti i valori nella Url proprietà non racchiusi tra parentesi graffe vengono considerati costanti letterali.

Il ? carattere non è consentito nella Url proprietà . Ogni segmento di URL deve essere separato da una costante delimitatore o letterale. È possibile usare {{ o }} come caratteri di escape per un carattere di parentesi graffa.

Si applica a

Vedi anche