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 -> 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
item
ist null
.
name
wird bereits in der Auflistung verwendet.
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie einem RouteCollection Objekt eine Route hinzufügen und dem 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 zur Routesammlung 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 verwenden, um eine URL zu erstellen. Die Angabe einer bestimmten Route ist wichtig, wenn mehr als eine Route den Werten entspricht, 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: Erstellen von URLs aus 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 Methode und die GetReadLock GetWriteLock Methode, um sicherzustellen, dass Sie ohne Konflikte aus anderen Prozessen mit der Auflistung interagieren.