DataGridViewColumnCollection.IList.Add(Object) Méthode

  • Référence

Définition

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

Ajoute un objet à la fin de 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 à la fin de la collection. La valeur peut être null.

Retours

Int32

Index auquel value a été ajouté.

Implémente

Add(Object)

Exceptions

InvalidCastException

value n’est pas un DataGridViewColumn.

ArgumentNullException

value a la valeur null.

InvalidOperationException

Le contrôle DataGridView associé exécute l'une des opérations suivantes qui empêchent temporairement l'ajout de nouvelles colonnes :

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

  • Suppression de la sélection.

  • Mise à jour des valeurs de propriété de colonne DisplayIndex .

- ou -

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

- ou -

La colonne indiquée par value appartient déjà à un contrôle DataGridView.

- ou -

La valeur de propriété SortMode de la colonne indiquée par value est Automatic et la valeur de propriété SelectionMode est FullColumnSelect ou ColumnHeaderSelect. Utilisez les méthodes ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() du contrôle pour définir temporairement des valeurs de propriétés en conflit.

- ou -

La valeur de propriété InheritedAutoSizeMode de la colonne indiquée par value est ColumnHeader et la valeur de propriété ColumnHeadersVisible est false.

- ou -

La colonne indiquée par value a une valeur de propriété InheritedAutoSizeMode de Fill et une valeur de propriété Frozen de true.

- ou -

La colonne indiquée par value a une valeur de propriété FillWeight qui ferait en sorte que les valeurs FillWeight combinées de toutes les colonnes dans le contrôle dépassent 65 535.

- ou -

La colonne indiquée par value a des valeurs de propriété DisplayIndex et Frozen qui l'afficheraient parmi un jeu de colonnes adjacentes avec la valeur de propriété Frozen opposée.

- ou -

Le contrôle DataGridView contient au moins une ligne et la colonne indiquée par value a une valeur de propriété CellType de null.

Remarques

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

S’applique à

Voir aussi