DataGridViewRowCollection.Add Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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()

Source:

DataGridViewRowCollection.cs

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

Int32

Index de la nouvelle ligne.

Exceptions

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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.

ArgumentException

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

Add(Int32)

Source:

DataGridViewRowCollection.cs

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

Int32

Index de la dernière ligne qui a été ajoutée.

Exceptions

ArgumentOutOfRangeException

count est inférieur à 1.

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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

• DataGridView
• DataGridViewRow

Add(Object[])

Source:

DataGridViewRowCollection.cs

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

Int32

Index de la nouvelle ligne.

Exceptions

ArgumentNullException

values a la valeur null.

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Source:

DataGridViewRowCollection.cs

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

dataGridViewRow

DataGridViewRow

DataGridViewRow à ajouter à DataGridViewRowCollection.

Retours

Int32

Index de la nouvelle DataGridViewRow.

Exceptions

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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.

ArgumentNullException

dataGridViewRow a la valeur null.

ArgumentException

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