DataGridViewRowCollection.InsertCopy(Int32, Int32) Méthode

  • Référence

Définition

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

Insère une ligne dans la collection à la position spécifiée, selon la ligne à la position spécifiée.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);
public virtual void InsertCopy (int indexSource, int indexDestination);
abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit
Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

Paramètres

indexSource
Int32

Index de la ligne sur laquelle baser la nouvelle ligne.

indexDestination
Int32

Position à laquelle insérer la ligne.

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.

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 :

- ou -

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

- ou -

Cette opération insérerait une ligne figée après des lignes non figées ou une ligne non figée avant des lignes figées.

Remarques

Cette méthode affecte à la nouvelle ligne l’index spécifié dans le indexDestination paramètre et incrémente les index de toutes les lignes suivantes. La InheritedStyle propriété du nouveau DataGridViewRow a les mêmes valeurs que le InheritedStyle de positionné DataGridViewRow sur indexSource. La InsertCopy méthode ajoute une ligne partagée à , DataGridViewRowCollectionsi 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 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