RouteCollection.Add(String, RouteBase) Méthode

Définition

Espace de noms:

System.Web.Routing

Assembly:

System.Web.dll

Ajoute un itinéraire à la fin de l’objet RouteCollection et assigne 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 -> unit

Public 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

ArgumentNullException

item a la valeur null.

ArgumentException

name est déjà utilisé dans la collection.

Exemples

L’exemple suivant montre comment ajouter un itinéraire à un RouteCollection objet et lui attribuer un nom.

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 de routes. 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. Il est important de spécifier un itinéraire particulier 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 le premier itinéraire de la collection qui correspond aux valeurs. Pour plus d’informations, consultez Guide pratique pour construire des URL à partir d’itinéraires.

Un nom ne peut être utilisé qu’une seule fois dans l’objet RouteCollection .

Si vous n’avez pas besoin de spécifier un 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 conflits d’autres processus.

Voir aussi

• Routage ASP.NET