Assembly : System (dans system.dll)
SyntaxePublic Sub Add ( _ key As TKey, _ value As TValue _ )
Dim instance As SortedList(Of TKey, TValue) Dim key As TKey Dim value As TValue instance.Add(key, value)
public void Add ( TKey key, TValue value )
public: virtual void Add ( TKey key, TValue value ) sealed
public final void Add ( TKey key, TValue value )
public final function Add ( key : TKey, value : TValue )
Paramètres
- key
Clé de l'élément à ajouter.
- value
Valeur de l'élément à ajouter. La valeur peut être référence Null (Nothing en Visual Basic) pour les types référence.
Exceptions
NotesUne clé ne peut pas être référence Null (Nothing en Visual Basic), mais une valeur peut l'être si le type des valeurs de la liste triée, TValue, est un type référence.
Vous pouvez aussi utiliser la propriété Item pour ajouter de nouveaux éléments en définissant la valeur d'une clé qui n'existe pas dans SortedList ; par exemple, myCollection["myNonexistentKey"] = myValue. Cependant, si la clé spécifiée existe déjà dans SortedList, la définition de la propriété Item remplace l'ancienne valeur. Par contre, la méthode Add ne modifie pas les éléments existants.
Si Count équivaut déjà à Capacity, la capacité de SortedList est augmentée en réallouant automatiquement le tableau interne ; en outre, les éléments existants sont copiés dans le nouveau tableau avant que le nouvel élément ne soit ajouté.
Cette méthode est une opération O(n) pour les données non triées, où n est égal à Count. Il s'agit d'une opération O(log n) si le nouvel élément est ajouté à la fin de la liste. Si l'insertion conduit à un redimensionnement, l'opération est O(n).
ExempleL'exemple de code suivant crée un SortedList de chaînes vide, avec des clés de chaînes, et utilise la méthode Add pour ajouter certains éléments. L'exemple montre que la méthode Add lève ArgumentException lors de la tentative d'ajout d'une clé dupliquée.
Cet exemple de code fait partie d'un exemple plus développé fourni pour la classe SortedList.
' Create a new sorted list of strings, with string ' keys. Dim openWith As New SortedList(Of String, String) ' Add some elements to the list. There are no ' duplicate keys, but some of the values are duplicates. openWith.Add("txt", "notepad.exe") openWith.Add("bmp", "paint.exe") openWith.Add("dib", "paint.exe") openWith.Add("rtf", "wordpad.exe") ' The Add method throws an exception if the new key is ' already in the list. Try openWith.Add("txt", "winword.exe") Catch Console.WriteLine("An element with Key = ""txt"" already exists.") End Try
// Create a new sorted list of strings, with string // keys. SortedList<string, string> openWith = new SortedList<string, string>(); // Add some elements to the list. There are no // duplicate keys, but some of the values are duplicates. openWith.Add("txt", "notepad.exe"); openWith.Add("bmp", "paint.exe"); openWith.Add("dib", "paint.exe"); openWith.Add("rtf", "wordpad.exe"); // The Add method throws an exception if the new key is // already in the list. try { openWith.Add("txt", "winword.exe"); } catch (ArgumentException) { Console.WriteLine("An element with Key = \"txt\" already exists."); }
Plates-formesWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ