Route.Url Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.Routing
Assembly:
System.Web.Routing.dll
Assembly:
System.Web.dll

Ruft das URL-Muster für die Route ab oder legt es fest.

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 Vergleichen der Route mit einer URL.

Ausnahmen

ArgumentException

Einer der folgenden Punkte trifft zu:

  • Der Wert beginnt mit ~ oder /.

  • Der Wert enthält ein ? Zeichen.

  • Der Catch-All-Parameter ist nicht zuletzt.

Exception

URL-Segmente sind nicht durch ein Trennzeichen oder eine literale Konstante getrennt.

Beispiele

Im folgenden Beispiel wird gezeigt, 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 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 Url Eigenschaft, die nicht in Klammern eingeschlossen sind, werden als Literalkonstanten behandelt.

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

Gilt für:

Weitere Informationen