RouteCollection.Add(String, RouteBase) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un itinéraire à la fin de l’objet RouteCollection et affecte le nom spécifié à l’itinéraire.
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)Paramètres
- name
- String
Valeur qui identifie l’itinéraire. La valeur peut être null ou une chaîne vide.
- item
- RouteBase
Itinéraire à ajouter à la fin de la collection.
Exceptions
item a la valeur null.
name est déjà utilisé dans la collection.
Exemples
L’exemple suivant montre comment ajouter un itinéraire à un RouteCollection objet et affecter un nom à l’itinéraire.
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
Remarques
La Add méthode vous permet de définir un nom pour un itinéraire lorsque vous l’ajoutez à la collection d’itinéraires. En définissant un nom pour l’itinéraire, vous pouvez spécifier un itinéraire particulier à utiliser lorsque vous utilisez le routage pour construire une URL. La spécification d’un itinéraire particulier est importante lorsque plusieurs itinéraires correspondent aux valeurs que vous passez à la GetVirtualPath méthode. Si vous ne spécifiez pas d’itinéraire nommé, ASP.NET routage utilise la première route de la collection qui correspond aux valeurs. Pour plus d’informations, consultez How to : Construct URLs from Routes.
Un nom ne peut être utilisé qu’une seule fois dans l’objet RouteCollection .
Si vous n’avez pas à spécifier de nom pour l’itinéraire, vous pouvez ajouter l’itinéraire en appelant la Add méthode.
Utilisez la GetReadLock méthode et la GetWriteLock méthode pour vous assurer que vous interagissez avec la collection sans conflit avec d’autres processus.
