Public 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.

Une 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).

L'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.");
}

Windows 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.

.NET Framework

.NET Compact Framework