Exporter (0) Imprimer
Développer tout

OrderedDictionary.Insert, méthode

Mise à jour : novembre 2007

Insère une nouvelle entrée dans la collection OrderedDictionary avec la clé et la valeur spécifiées à l'index spécifié.

Espace de noms :  System.Collections.Specialized
Assembly :  System (dans System.dll)

public void Insert(
	int index,
	Object key,
	Object value
)
public final void Insert(
	int index,
	Object key,
	Object value
)
public final function Insert(
	index : int, 
	key : Object, 
	value : Object
)

Paramètres

index
Type : System.Int32

Index de base zéro auquel l'élément doit être inséré.

key
Type : System.Object

Clé de l'entrée à ajouter.

value
Type : System.Object

Valeur de l'entrée à ajouter. La valeur peut être null.

Implémentations

IOrderedDictionary.Insert(Int32, Object, Object)

ExceptionCondition
ArgumentOutOfRangeException

indexest hors limites.

NotSupportedException

Cette collection est en lecture seule.

Si le paramètre index est égal au nombre d'entrées dans la collection OrderedDictionary, les paramètres key et value sont ajoutés à la fin de la collection.

Les entrées qui suivent le point d'insertion se déplacent vers le bas pour laisser de la place à la nouvelle entrée et les index des entrées déplacées sont mis à jour.

L'exemple de code suivant illustre la modification d'une collection OrderedDictionary. Dans cet exemple, la méthode Insert est utilisée pour ajouter une nouvelle entrée au début de OrderedDictionary et déplacer le reste des entrées vers le bas. Ce code fait partie d'un exemple de code plus développé qui peut être affiché dans OrderedDictionary.

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft