RouteCollection.Add(String, RouteBase) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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
item ist null.
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.
