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

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insère un DataGridViewRow dans la collection à 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

Le DataGridViewRow à insérer dans le DataGridViewRowCollection.

Implémente

Insert(Int32, Object)

Exceptions

InvalidCastException

value n’est pas un DataGridViewRow.

ArgumentOutOfRangeException

index est inférieur à zéro ou supérieur au nombre de lignes dans la collection.

ArgumentNullException

value a la valeur null.

InvalidOperationException

Le contrôle DataGridView associé exécute l’une des opérations suivantes qui empêche temporairement l’ajout de nouvelles lignes :

• Sélection de toutes les cellules du contrôle.

• Effacement de la sélection.

- ou -

Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

La propriété DataSource de DataGridView n’est pas null.

- ou -

index est égal au nombre de lignes dans la collection, et la propriété AllowUserToAddRows de DataGridView a la valeur true.

- ou -

DataGridView ne possède aucune colonne.

- ou -

La propriété DataGridView de value n’est pas null.

- ou -

value a une valeur de propriété Selected de true.

- ou -

Cette opération insérerait une ligne figée après des lignes non figées ou une ligne non figée avant des lignes figées.

ArgumentException

value contient plus de cellules qu’il n’y a de colonnes.

Remarques

Ce membre est une implémentation d'un membre d'interface explicite. Il peut uniquement être utilisé lorsque l'instance de DataGridViewRowCollection est castée en interface IList.

Cette méthode appelle la Insert(Int32, DataGridViewRow) surcharge, en lui transmettant la valeur après avoir été castée en DataGridViewRow.

Les lignes du contrôle ne sont pas automatiquement triées lorsque de nouvelles lignes sont ajoutées. Pour trier les nouvelles lignes dans leur position correcte, appelez la DataGridView.Sort méthode dans un gestionnaire d’événements DataGridView.RowsAdded . Vous pouvez également appeler la DataGridView.Sort méthode dans un gestionnaire d’événements CellValueChanged pour trier les lignes lorsque l’utilisateur modifie une cellule.

Voir aussi

• DataGridView
• DataGridViewRow
• IList