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

Définition

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);
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

Exceptions

index est inférieur à zéro.

- ou -

index est supérieur à Count.

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.

S’applique à

Voir aussi