Partager via


DataGridViewRowCollection.Add Méthode

Définition

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 -> int
Public Overridable Function Add () As Integer

Retours

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

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 -> int
Public Overridable Function Add (count As Integer) As Integer

Paramè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[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

Paramè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 -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Paramètres

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

S’applique à