Route.Url Eigenschaft

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Dient zum Abrufen oder Festlegen des URL-Musters für die 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

Eigenschaftswert

String

Das Muster zum Abgleichen der Route zu einer URL.

Ausnahmen

ArgumentException

Eine der folgenden Optionen:

• Der Wert beginnt mit ~ oder /.

• Der Wert enthält ein ? Zeichen.

• Der Catch-All-Parameter ist nicht zuletzt vorhanden.

Exception

URL-Segmente werden nicht durch ein Trennzeichen oder eine Literalkonstante getrennt.

Beispiele

Das folgende Beispiel zeigt, wie die Url Eigenschaft im Klassenkonstruktor festgelegt wird. Das Muster enthält den Literalwert "Category" für das erste Segment und die URL-Parameter für die nächsten beiden Segmente.

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

Hinweise

Wenn Sie der Url Eigenschaft einen Wert zuweisen, wird das / Zeichen als Trennzeichen interpretiert, wenn die URL analysiert wird. Verwenden Sie geschweifte Klammern ({}), um eine Variable zu definieren, die als URL-Parameter bezeichnet wird. Der Wert aus dem übereinstimmenden Segment in der URL wird dem URL-Parameter zugewiesen. Alle Werte in der Eigenschaft, die Url nicht in geschweifte Klammern eingeschlossen sind, werden als Literalkonstanten behandelt.

Das ? Zeichen ist in der Url Eigenschaft nicht zulässig. Jedes URL-Segment muss durch ein Trennzeichen oder eine Literalkonstante getrennt werden. Sie können escapezeichen für ein geschweiftes Zeichen verwenden oder }} als Escapezeichen verwenden{{.

Weitere Informationen

• ASP.NET Routing