DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insère des lignes dans la collection au niveau de la position spécifiée.

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);

public virtual void InsertCopies (int indexSource, int indexDestination, int count);

abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit

Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Paramètres

indexSource

Int32

Index de l’objet DataGridViewRow sur lequel baser les nouvelles lignes.

indexDestination

Int32

Position à laquelle insérer les lignes.

count

Int32

Nombre d’objets DataGridViewRow à ajouter à DataGridViewRowCollection.

Exceptions

ArgumentOutOfRangeException

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

- ou -

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

- ou -

count est inférieur à 1.

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 -

indexDestination est égal au nombre de lignes dans la collection et AllowUserToAddRows a la valeur true.

- ou -

Cette opération insère des lignes figées après des lignes non figées ou des lignes non figées avant des lignes figées.

Remarques

La InheritedStyle propriété des nouveaux DataGridViewRow objets a les mêmes valeurs que le InheritedStyle de positionné DataGridViewRow sur indexSource. La InsertCopies méthode ajoute des lignes partagées au DataGridViewRowCollection, si possible. Sinon, les nouvelles lignes ne sont pas partagée. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

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