語言

Route.Url 屬性

定義

命名空間:
System.Web.Routing
組件:
System.Web.Routing.dll
組件:
System.Web.dll

取得或設定路由的網址模式。

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

屬性值

String

路由與網址匹配的模式。

例外狀況

ArgumentException

以下任一：

  • 該值以或 ~開頭/。

  • 該值包含一個 ? 字元。

  • 包羅萬象的參數不是最後的。

Exception

URL 段之間沒有分隔符或字面常數。

範例

以下範例說明如何在類別建構子中設定該 Url 屬性。 該模式包含第一個區段的字面值「Category」，以及接下來兩個區段的網址參數。

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

備註

當你為屬性指派值 Url 時，解析 URL 時，該 / 字元會被解讀為分隔符。 使用大括號（{}）來定義一個變數，稱為 URL 參數。 URL 中匹配區段的值會被指派到 URL 參數。 屬性中 Url 未被大括號包圍的值視為字面常數。

該 ? 角色不被允許出現在該 Url 物業中。 每個 URL 區段必須以分隔符或文字常數分隔。 你可以用 {{ 或 }} 當作支撐角色的逃脫角色。

適用於

另請參閱