DataGridViewRowCollection.AddCopies(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.
Ajoute le nombre spécifié de lignes à la collection en fonction de la ligne à 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 au DataGridViewRowCollection.
Retours
Index de la dernière ligne ajoutée.
Exceptions
indexSource est inférieur à zéro ou supérieur ou égal au nombre de lignes du contrôle.
- ou -
count est inférieur à zéro.
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 -
La DataSource propriété de l’objet DataGridView n’est pas null.
- ou -
Cette opération ajouterait une ligne figée après les lignes non supprimées.
Remarques
La InheritedStyle propriété du nouveau DataGridViewRow a les mêmes valeurs que la InheritedStyleDataGridViewRow position à indexSource. La AddCopies 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.