Route.Url 屬性

定義

命名空間:

System.Web.Routing

組件:

System.Web.dll

取得或設定路由的 URL 模式。

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

比對路由與 URL 的模式。

例外狀況

ArgumentException

下列任何一項：

• 值以 ~ 或 / 開頭。

• 值包含 ? 字元。

• catch-all 參數不是最後一個參數。

Exception

沒有以分隔符號或常值常數分隔 URL 區段。

範例

下列範例示範如何在類別建構函式中設定 Url 屬性。 此模式包含第一個區段的常值 「Category」，以及下兩個區段的 URL 參數。

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 區段都必須以分隔符號或常值常數分隔。 您可以使用 {{ 或 }} 作為大括弧字元的逸出字元。

另請參閱

• ASP.NET 路由