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

Определение

Добавляет маршрут в конец объекта 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

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

Исключения

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

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 , чтобы обеспечить взаимодействие с коллекцией без конфликтов со стороны других процессов.

Применяется к

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