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