RouteCollection.Add(String, RouteBase) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een route toe aan het einde van het RouteCollection object en wijst u de opgegeven naam toe aan de route.
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)Parameters
- name
- String
De waarde waarmee de route wordt geïdentificeerd. De waarde kan of een lege tekenreeks zijn null .
- item
- RouteBase
De route die moet worden toegevoegd aan het einde van de verzameling.
Uitzonderingen
item is null.
name wordt al gebruikt in de verzameling.
Voorbeelden
In het volgende voorbeeld ziet u hoe u een route aan een RouteCollection object toevoegt en een naam aan de route toewijst.
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
Opmerkingen
Met Add de methode kunt u een naam voor een route definiëren wanneer u deze aan de routeverzameling toevoegt. Door een naam voor de route te definiëren, kunt u een bepaalde route opgeven die moet worden gebruikt wanneer u routering gebruikt om een URL te maken. Het opgeven van een bepaalde route is belangrijk wanneer meer dan één route overeenkomt met de waarden die u aan de GetVirtualPath methode doorgeeft. Als u geen benoemde route opgeeft, gebruikt ASP.NET routering de eerste route in de verzameling die overeenkomt met de waarden. Zie How to: Construct URL's from Routes(URL's maken) voor meer informatie.
Een naam kan slechts één keer in het RouteCollection object worden gebruikt.
Als u geen naam voor de route hoeft op te geven, kunt u de route toevoegen door de methode aan te Add roepen.
Gebruik de GetReadLock methode en de GetWriteLock methode om ervoor te zorgen dat u met de verzameling communiceert zonder conflicten van andere processen.