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 der Route 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 eine leere Zeichenfolge oder eine leere Zeichenfolge sein null .
- 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 RouteCollection Objekt eine 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 der Add Methode können Sie einen Namen für eine Route definieren, wenn Sie sie der Routenauflistung hinzufügen. Durch Definieren eines Namens für die Route können Sie eine bestimmte Route angeben, die verwendet werden soll, wenn Sie routing zum Erstellen einer URL verwenden. Die Angabe einer bestimmten Route ist wichtig, wenn mehr als eine Route mit den Werten übereinstimmt, 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 How to: Construct URLs from Routes.
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.
