Collection.IList.Insert(Int32, Object) Méthode

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

Insère un élément dans l'objet Collection au niveau de l'index spécifié.

 virtual void IListInsert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object value);

abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit

Sub IListInsert (index As Integer, value As Object) Implements IList.Insert

Paramètres

index

Int32

Index de base zéro au niveau duquel value doit être inséré.

value

Object

Object à insérer dans l'objet Collection.

Exceptions

ArgumentOutOfRangeException

index n'est pas un index valide dans l'objet Collection.

NotSupportedException

L'objet Collection est en lecture seule.

- ou -

L'objet Collection est de taille fixe.

NullReferenceException

value est une référence null dans l'objet Collection.

Remarques

Si index est égal au nombre d’éléments dans l’objet Collection , value est ajouté à la fin.

Dans des collections d’éléments contigus, telles que les listes, les éléments situés après le point d’insertion descendent afin de prendre en compte le nouvel élément. Si la collection est indexée, les index des éléments déplacés sont également mis à jour. Ce comportement ne s'applique pas aux collections dont les éléments sont regroupés de manière conceptuelle en compartiments, comme par exemple les tables de hachage.

Voir aussi

• Collection
• IList
• Insert(Int32, Object)