RouteCollection.Add(String, RouteBase) Метод

Определение

Пространство имен:

System.Web.Routing

Сборка:

System.Web.Routing.dll

Сборка:

System.Web.dll

Добавляет маршрут в конец объекта RouteCollection и назначает этому маршруту указанное имя.

public:
 void Add(System::String ^ name, System::Web::Routing::RouteBase ^ item);

public void Add (string name, System.Web.Routing.RouteBase item);

override this.Add : string * System.Web.Routing.RouteBase -> unit

Public Sub Add (name As String, item As RouteBase)

Параметры

name

String

Значение, определяющее маршрут. Этим значением может быть null или пустая строка.

item

RouteBase

Маршрут, добавляемый в конец коллекции.

Исключения

ArgumentNullException

item имеет значение null.

ArgumentException

name уже используется в коллекции.

Примеры

В следующем примере показано, как добавить маршрут к RouteCollection объекту и назначить имя маршруту.

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Комментарии

Этот Add метод позволяет определить имя маршрута при добавлении его в коллекцию маршрутов. Определив имя маршрута, можно указать конкретный маршрут, используемый при использовании маршрутизации для создания URL-адреса. Указание определенного маршрута важно, если несколько маршрутов соответствуют значениям, которые передаются в GetVirtualPath метод. Если не указать именованный маршрут, ASP.NET маршрутизация будет использовать первый маршрут в коллекции, которая соответствует значениям. Дополнительные сведения см. в разделе "Практическое руководство. Создание URL-адресов из маршрутов".

Имя может использоваться только один раз в объекте RouteCollection .

Если вам не нужно указывать имя маршрута, можно добавить маршрут, вызвав Add метод.

GetReadLock Используйте метод и GetWriteLock метод, чтобы убедиться, что вы взаимодействуете с коллекцией без конфликтов из других процессов.

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

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