DataGridViewColumnCollection.IList.Insert(Int32, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Insère un élément 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é.
Implémente
Exceptions
value
n’est pas un DataGridViewColumn.
value
a la valeur null
.
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 contenues dans le contrôle.
Effacement de la sélection.
Mise à jour des valeurs de propriété DisplayIndex de la colonne.
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 estfalse
.ou - La colonne indiquée par
value
a une valeur de propriété InheritedAutoSizeMode de Fill et une valeur de propriété Frozen detrue
.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 denull
.
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.