ListBox.ObjectCollection.Insert(Int32, Object) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insère un élément dans la zone de liste à l'index spécifié.

public:
 virtual void Insert(int index, System::Object ^ item);

public:
 void Insert(int index, System::Object ^ item);

public void Insert (int index, object item);

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

member this.Insert : int * obj -> unit

Public Sub Insert (index As Integer, item As Object)

Paramètres

index

Int32

Emplacement de l’index de base zéro où l’élément est inséré.

item

Object

Objet représentant l’élément à insérer.

Implémente

Insert(Int32, Object)

Exceptions

ArgumentOutOfRangeException

Le paramètre index est inférieur à zéro ou supérieur à la valeur de la propriété Count de la classe ListBox.ObjectCollection.

ArgumentNullException

item a la valeur null.

Remarques

Cette méthode vous permet d’insérer un élément à une position spécifique dans le ListBox. Si la Sorted propriété du ListBox paramètre est définie sur true, l’élément est ajouté à la position correcte dans la liste triée, quelles que soient les valeurs spécifiées dans le index paramètre. Lorsqu’un objet est ajouté à la collection, le ListBox premier vérifie si la DisplayMember propriété de la ListControl classe a le nom d’un membre de l’objet spécifié pour référencer lors de l’obtention du texte de l’élément. Si la DisplayMember propriété n’a pas de membre spécifié, elle ListBox appelle la méthode de l’objet pour obtenir le ToString texte à afficher dans la liste.