Route.Url Vlastnost

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.dll

Získá nebo nastaví vzor adresy URL pro trasu.

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

Hodnota vlastnosti

String

Vzor pro porovnávání trasy s adresou URL.

Výjimky

ArgumentException

Některou z následujících možností:

• Hodnota začíná ~ nebo /.

• Hodnota obsahuje ? znak.

• Parametr catch-all není poslední.

Exception

Segmenty adresy URL nejsou oddělené oddělovačem nebo literálovou konstantou.

Příklady

Následující příklad ukazuje, jak nastavit Url vlastnost v konstruktoru třídy. Vzor obsahuje literálovou hodnotu Category (Kategorie) pro první segment a parametry adresy URL pro další dva segmenty.

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

Poznámky

Když vlastnost přiřadíte hodnotu Url , / znak se při analýze adresy URL interpretuje jako oddělovač. Pomocí složených závorek ({}) definujte proměnnou, která se označuje jako parametr adresy URL. Hodnota z odpovídajícího segmentu v adrese URL je přiřazena k parametru adresy URL. Všechny hodnoty ve Url vlastnosti, které nejsou uzavřeny ve složených závorkách, jsou považovány za literální konstanty.

Znak ? není ve Url vlastnosti povolen. Každý segment adresy URL musí být oddělený oddělovačem nebo literálovou konstantou. Pro složený znak můžete použít {{ řídicí znaky nebo }} jako řídicí znaky.

Viz také

• směrování ASP.NET