DataGridViewRowCollection.AddCopies(Int32, Int32) Méthode

Définition

Ajoute le nombre spécifié de lignes à la collection en fonction de la ligne située à l’index spécifié.

public:
 virtual int AddCopies(int indexSource, int count);
public virtual int AddCopies (int indexSource, int count);
abstract member AddCopies : int * int -> int
override this.AddCopies : int * int -> int
Public Overridable Function AddCopies (indexSource As Integer, count As Integer) As Integer

Paramètres

indexSource
Int32

Index de la ligne sur laquelle baser les nouvelles lignes.

count
Int32

Nombre de lignes à ajouter à DataGridViewRowCollection.

Retours

Index de la dernière ligne qui a été ajoutée.

Exceptions

indexSource est inférieur à zéro, ou supérieur ou égal au nombre de lignes dans le contrôle.

- ou -

count est inférieur à zéro.

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 -

Cette opération ajoute une ligne figée après des lignes non figées.

Remarques

La InheritedStyle propriété du nouveau DataGridViewRow a les mêmes valeurs que le InheritedStyle de positionné DataGridViewRow sur indexSource. La AddCopies 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.

S’applique à

Voir aussi