Route.Url Właściwość

Definicja

Przestrzeń nazw:

System.Web.Routing

Zestaw:

System.Web.dll

Pobiera lub ustawia wzorzec adresu URL dla trasy.

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

Wartość właściwości

String

Wzorzec dopasowywania trasy do adresu URL.

Wyjątki

ArgumentException

Dowolne z następujących elementów:

• Wartość zaczyna się od ~ lub /.

• Wartość zawiera ? znak.

• Parametr catch-all nie jest ostatni.

Exception

Segmenty adresów URL nie są rozdzielane ogranicznikiem ani stałą literału.

Przykłady

W poniższym przykładzie pokazano, jak ustawić Url właściwość w konstruktorze klasy. Wzorzec zawiera wartość literału "Category" dla pierwszego segmentu i parametrów adresu URL dla następnych dwóch segmentów.

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

Uwagi

Po przypisaniu wartości do Url właściwości / znak jest interpretowany jako ogranicznik podczas analizowania adresu URL. Użyj nawiasów klamrowych ({}), aby zdefiniować zmienną, która jest określana jako parametr adresu URL. Wartość z pasującego segmentu w adresie URL jest przypisywana do parametru adresu URL. Wszystkie wartości we Url właściwości, które nie są ujęte w nawiasy klamrowe, są traktowane jako stałe literału.

Znak ? nie jest dozwolony we Url właściwości . Każdy segment adresu URL musi być oddzielony ogranicznikiem lub stałą literału. Można użyć {{ znaków ucieczki lub }} jako znaków ucieczki dla znaku nawiasu klamrowego.

Zobacz też

• ASP.NET Routing