RouteCollection.Add(String, RouteBase) Metoda

Definicja

Przestrzeń nazw:

System.Web.Routing

Zestaw:

System.Web.dll

Dodaje trasę na końcu RouteCollection obiektu i przypisuje określoną nazwę do trasy.

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)

Parametry

name

String

Wartość identyfikującą trasę. Wartość może być null lub pusty ciąg.

item

RouteBase

Trasa do dodania na końcu kolekcji.

Wyjątki

ArgumentNullException

item to null.

ArgumentException

name jest już używany w kolekcji.

Przykłady

W poniższym przykładzie pokazano, jak dodać trasę do RouteCollection obiektu i przypisać nazwę do trasy.

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

Uwagi

Metoda Add umożliwia zdefiniowanie nazwy trasy podczas dodawania jej do kolekcji tras. Definiując nazwę trasy, można określić określoną trasę do użycia, gdy używasz routingu do konstruowania adresu URL. Określenie określonej trasy jest ważne, gdy więcej niż jedna trasa jest zgodna z wartościami przekazywanymi do GetVirtualPath metody. Jeśli nie określisz nazwanej trasy, ASP.NET routing użyje pierwszej trasy w kolekcji zgodnej z wartościami. Aby uzyskać więcej informacji, zobacz Instrukcje: konstruowanie adresów URL z tras.

Nazwa może być używana tylko raz w RouteCollection obiekcie.

Jeśli nie musisz określać nazwy trasy, możesz dodać trasę, wywołując metodę Add .

GetReadLock Użyj metody i GetWriteLock metody, aby upewnić się, że wchodzisz w interakcję z kolekcją bez konfliktów z innymi procesami.

Zobacz też

• ASP.NET Routing