Udostępnij za pośrednictwem

RouteCollection.Add(String, RouteBase) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Routing
Zestaw:
System.Web.Routing.dll
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.

Dotyczy

Zobacz też