DataGridViewRowCollection.IList.Add(Object) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ajoute un DataGridViewRow à la collection.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Paramètres

value
Object

Object à ajouter à IList.

Retours

Int32

Index de la nouvelle DataGridViewRow.

Implémente

Add(Object)

Exceptions

InvalidCastException

value n’est pas un DataGridViewRow.

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 :

- ou -

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

- 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 ajoute une ligne figée après des lignes non figées.

ArgumentNullException

value a la valeur null.

ArgumentException

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

Remarques

Cette méthode est une implémentation de 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 Add(DataGridViewRow) surcharge, en la transmettant après la conversion en value .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.

S’applique à

Voir aussi