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" と、次の 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 ルーティング