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-адреса должен быть разделен разделителем или константой литерала. Вы можете использовать {{ или }} в качестве escape-символов для символа фигурной скобки.

См. также раздел

• ASP.NET маршрутизация