RouteCollection.Add(String, RouteBase) Methode

Definition

Namespace:

System.Web.Routing

Assembly:

System.Web.dll

Fügt am Ende des RouteCollection-Objekts eine Route hinzu und weist dieser den angegebenen Namen zu.

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)

Parameter

name

String

Der Wert, der die Route identifiziert. Der Wert kann null oder eine leere Zeichenfolge sein.

item

RouteBase

Die Route, die am Ende der Auflistung hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

item ist null.

ArgumentException

name wird bereits in der Auflistung verwendet.

Beispiele

Das folgende Beispiel zeigt, wie Sie einem -Objekt eine RouteCollection Route hinzufügen und der Route einen Namen zuweisen.

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

Hinweise

Mit Add der -Methode können Sie einen Namen für eine Route definieren, wenn Sie sie der Routensammlung hinzufügen. Indem Sie einen Namen für die Route definieren, können Sie eine bestimmte Route angeben, die verwendet werden soll, wenn Sie routing zum Erstellen einer URL verwenden. Das Angeben einer bestimmten Route ist wichtig, wenn mehrere Routen mit den Werten übereinstimmen, die Sie an die GetVirtualPath -Methode übergeben. Wenn Sie keine benannte Route angeben, verwendet ASP.NET Routing die erste Route in der Auflistung, die den Werten entspricht. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen von URLs aus Routen.

Ein Name kann nur einmal im RouteCollection -Objekt verwendet werden.

Wenn Sie keinen Namen für die Route angeben müssen, können Sie die Route hinzufügen, indem Sie die Add -Methode aufrufen.

Verwenden Sie die GetReadLock -Methode und die GetWriteLock -Methode, um sicherzustellen, dass Sie ohne Konflikte aus anderen Prozessen mit der Auflistung interagieren.

Weitere Informationen

• ASP.NET-Routing