DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) 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 des lignes dans la collection à 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 -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)Paramètres
- indexSource
- Int32
Index sur DataGridViewRow lequel baser les nouvelles lignes.
- indexDestination
- Int32
Position à laquelle insérer les lignes.
- count
- Int32
Nombre d’objets DataGridViewRow à ajouter au DataGridViewRowCollection.
Exceptions
indexSource est inférieur à zéro ou supérieur au nombre de lignes de la collection moins un.
- ou -
indexDestination est inférieur à zéro ou supérieur au nombre de lignes de la collection.
- ou -
count est inférieur à 1.
Le contrôle associé DataGridView effectue l’une des actions suivantes qui empêchent 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 pour l’un des événements suivants DataGridView :
- ou -
indexDestination est égal au nombre de lignes de la collection et AllowUserToAddRows est true.
- ou -
Cette opération insère des lignes figées après les lignes non vides ou les lignes non figées avant les lignes figées.
Remarques
La InheritedStyle propriété des nouveaux DataGridViewRow objets a les mêmes valeurs que la InheritedStyleDataGridViewRow position à indexSource. La InsertCopies méthode ajoute des lignes partagées au DataGridViewRowCollection, si possible. Sinon, les nouvelles lignes ne sont pas partagés. Pour plus d’informations, consultez Les 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.
