Partager via


DataGridViewRowCollection.AddCopy(Int32) Méthode

Définition

Ajoute une nouvelle ligne basée sur la ligne à l’index spécifié.

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

Paramètres

indexSource
Int32

Index de la ligne sur laquelle baser la nouvelle ligne.

Retours

Index de la nouvelle ligne.

Exceptions

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

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 dans le contrôle.

  • Suppression 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é de la nouvelle ligne a les mêmes valeurs que le InheritedStyle de la ligne positionnée sur indexSource. La AddCopy méthode ajoute une ligne partagée au DataGridViewRowCollection, si possible. Sinon, la nouvelle ligne n’est 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 triées automatiquement 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