Route.Url プロパティ

定義

名前空間:

System.Web.Routing

アセンブリ:

System.Web.Routing.dll

アセンブリ:

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

次のいずれかになります。

• 値が ~ または / で始まっています。

• 値が ? を含んでいます。 文字。

• キャッチオール パラメーターが最後のパラメーターではありません。

Exception

URL セグメントが区切り記号またはリテラル定数で区切られていません。

例

次の例は、クラス コンストラクターでプロパティを Url 設定する方法を示しています。 パターンには、最初のセグメントのリテラル値 "Category" と、次の 2 つのセグメントの 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 ルーティング