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

Définition

Espace de noms:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Source:

StringCollection.cs

Insère un élément dans la classe StringCollection au niveau de l'index spécifié.

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

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

abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit

Sub Insert (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. La valeur peut être null.

Implémente

Insert(Int32, Object)

Exceptions

ArgumentOutOfRangeException

index est inférieur à zéro.

- ou -

index est supérieur à Count.

NotSupportedException

StringCollection est en lecture seule.

- ou -

StringCollection est de taille fixe.

Remarques

Si Count est déjà égal à la capacité, la capacité du StringCollection est augmentée en réaffectant automatiquement le tableau interne, et les éléments existants sont copiés dans le nouveau tableau avant l’ajout du nouvel élément.

Si index est égal à Count, value est ajouté à la fin de StringCollection.

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.

Cette méthode est une opération O(n), où n est Count.

Voir aussi

• Add(Object)
• Remove(Object)
• Count