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

Nom	Description
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 le paramètre spécifié DataGridViewRow à 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 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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

La DataSource propriété de l’objet DataGridView n’est pas null.

- ou -

Il DataGridView n’y a pas de colonnes.

- ou -

Cette opération ajouterait une ligne figée après les lignes non supprimées.

ArgumentException

La ligne retournée par la RowTemplate propriété comporte plus de cellules qu’il y a des colonnes dans le contrôle.

Remarques

La Add() surcharge ajoute des lignes basées sur le RowTemplateDataGridView. 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 meilleure scalabilité. 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.

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

Retours

Int32

Index de la dernière ligne ajoutée.

Exceptions

ArgumentOutOfRangeException

count est inférieur à 1.

InvalidOperationException

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

La DataSource propriété de l’objet DataGridView n’est pas null.

- ou -

Il DataGridView n’y a pas de colonnes.

- ou -

La ligne retournée par la RowTemplate propriété comporte plus de cellules qu’il y a des colonnes dans le contrôle.

- ou -

Cette opération ajouterait des lignes figées après les lignes non supprimées.

Remarques

La Add(Int32) méthode ajoute des lignes partagées au DataGridViewRowCollection. Les nouvelles lignes sont basées sur le RowTemplateDataGridView. Assurez-vous que la ligne spécifiée dans la RowTemplate propriété peut être partagée pour une meilleure scalabilité. 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.

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

La propriété VirtualMode du DataGridView a la valeur true.

- ou -

La DataSource propriété de l’objet DataGridView n’est pas null.

- ou -

Il DataGridView n’y a pas de colonnes.

- ou -

La ligne retournée par la RowTemplate propriété comporte plus de cellules qu’il y a des colonnes dans le contrôle.

- ou -

Cette opération ajouterait une ligne figée après les lignes non supprimées.

Remarques

La Add(Object[]) méthode ajoute une ligne non partagé à l’objet DataGridViewRowCollection. 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.

Voir aussi

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Source:

DataGridViewRowCollection.cs

Ajoute le paramètre spécifié DataGridViewRow à 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 au DataGridViewRowCollection.

Retours

Int32

Index du nouveau DataGridViewRow.

Exceptions

InvalidOperationException

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou -

La DataSource propriété de l’objet DataGridView n’est pas null.

- ou -

Il DataGridView n’y a pas de colonnes.

- ou -

La DataGridView propriété de l’objet dataGridViewRow n’est pas null.

- ou -

dataGridViewRow a une Selected valeur de propriété de true.

- ou -

Cette opération ajouterait une ligne figée après les lignes non supprimées.

ArgumentNullException

dataGridViewRow a la valeur null.

ArgumentException

dataGridViewRow a plus de cellules qu’il y a de colonnes dans le contrôle.

Remarques

La Add(DataGridViewRow) méthode ajoute une ligne partagée au DataGridViewRowCollection, si possible. Sinon, la nouvelle ligne n’est pas partagé. 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.

Voir aussi

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Meilleures pratiques pour la mise à l’échelle du contrôle DataGridView Windows Forms