DataGridViewRowCollection.Add 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 une ou plusieurs lignes à la collection.
Surcharges
| Add() |
Ajoute une nouvelle ligne à la collection. |
| Add(Int32) |
Ajoute le nombre spécifié de nouvelles lignes à la collection. |
| Add(Object[]) |
Ajoute une nouvelle ligne à la collection et remplit les cellules avec les objets spécifiés. |
| Add(DataGridViewRow) |
Ajoute l'objet DataGridViewRow spécifié à la collection. |
Add()
Ajoute une nouvelle ligne à la collection.
public:
virtual int Add();public virtual int Add ();abstract member Add : unit -> int
override this.Add : unit -> intPublic Overridable Function Add () As IntegerRetours
Index de la nouvelle ligne.
Exceptions
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 -
DataGridView ne possède aucune colonne.
- ou -
Cette opération ajoute une ligne figée après des lignes non figées.
La ligne retournée par la propriété RowTemplate possède plus de cellules qu’il n’existe de colonnes dans le contrôle.
Remarques
La Add() surcharge ajoute des lignes basées sur le RowTemplateDataGridViewdu . La nouvelle ligne est partagée, si possible. Assurez-vous que la ligne spécifiée dans la RowTemplate propriété peut être partagée pour une scalabilité optimale. 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.
Voir aussi
- DataGridView
- DataGridViewRow
- Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms
S’applique à
Add(Int32)
Ajoute le nombre spécifié de nouvelles lignes à la collection.
public:
virtual int Add(int count);public virtual int Add (int count);abstract member Add : int -> int
override this.Add : int -> intPublic Overridable Function Add (count As Integer) As IntegerParamètres
- count
- Int32
Nombre de lignes à ajouter à DataGridViewRowCollection.
Retours
Index de la dernière ligne qui a été ajoutée.
Exceptions
count est inférieur à 1.
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 -
DataGridView ne possède aucune colonne.
- ou -
La ligne retournée par la propriété RowTemplate possède plus de cellules qu’il n’existe de colonnes dans le contrôle.
- ou -
Cette opération ajoute des lignes figées après des lignes non figées.
Remarques
La Add(Int32) méthode ajoute des lignes partagées à .DataGridViewRowCollection Les nouvelles lignes sont basées sur le RowTemplate de .DataGridView Assurez-vous que la ligne spécifiée dans la RowTemplate propriété peut être partagée pour une scalabilité optimale. 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.
Voir aussi
S’applique à
Add(Object[])
Ajoute une nouvelle ligne à la collection et remplit les cellules avec les objets spécifiés.
public:
virtual int Add(... cli::array <System::Object ^> ^ values);public virtual int Add (params object[] values);abstract member Add : obj[] -> int
override this.Add : obj[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParamètres
- values
- Object[]
Nombre variable d’objets qui remplissent les cellules du nouveau DataGridViewRow.
Retours
Index de la nouvelle ligne.
Exceptions
values a la valeur null.
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é VirtualMode du DataGridView a la valeur true.
- ou -
La propriété DataSource de DataGridView n’est pas null.
- ou -
DataGridView ne possède aucune colonne.
- ou -
La ligne retournée par la propriété RowTemplate possède plus de cellules qu’il n’existe de colonnes dans le contrôle.
- ou -
Cette opération ajoute une ligne figée après des lignes non figées.
Remarques
La Add(Object[]) méthode ajoute une ligne non partagée au DataGridViewRowCollection. 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.
Voir aussi
S’applique à
Add(DataGridViewRow)
Ajoute l'objet DataGridViewRow spécifié à la collection.
public:
virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParamètres
- dataGridViewRow
- DataGridViewRow
DataGridViewRow à ajouter à DataGridViewRowCollection.
Retours
Index de la nouvelle DataGridViewRow.
Exceptions
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 -
DataGridView ne possède aucune colonne.
- ou -
La propriété DataGridView de dataGridViewRow n’est pas null.
- ou -
dataGridViewRow a une valeur de propriété Selected de true.
- ou -
Cette opération ajoute une ligne figée après des lignes non figées.
dataGridViewRow a la valeur null.
dataGridViewRow contient plus de cellules qu’il n’y a de colonnes.
Remarques
La Add(DataGridViewRow) 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 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.
Voir aussi
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms
S’applique à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour