DataGridViewRowCollection.Insert Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ajoute une ou plusieurs lignes à la collection.

Surcharges

Insert(Int32, DataGridViewRow)

Insère le DataGridViewRow spécifié dans la collection.
Insert(Int32, Int32)

Insère le nombre de lignes spécifié dans la collection à l’emplacement spécifié.
Insert(Int32, Object[])

Insère une ligne dans la collection à la position spécifiée, et remplit les cellules avec les objets spécifiés.

Insert(Int32, DataGridViewRow)

Insère le DataGridViewRow spécifié dans la collection.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit
Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Paramètres

rowIndex
Int32

Position à laquelle insérer la ligne.

dataGridViewRow
DataGridViewRow

Le DataGridViewRow à insérer dans le DataGridViewRowCollection.

Exceptions

ArgumentOutOfRangeException

rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.

ArgumentNullException

dataGridViewRow 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 dans le contrôle.

  • Suppression 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 -

rowIndex est égal au nombre de lignes dans la collection, et la propriété AllowUserToAddRows de DataGridView a la valeur true.

- ou -

DataGridView ne possède aucune colonne.

- ou -

La propriété DataGridView de dataGridViewRow n'est pas le champ null.

- ou -

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

- ou -

Cette opération insérerait une ligne figée après des lignes non figées ou une ligne non figée avant des lignes figées.

ArgumentException

dataGridViewRow contient plus de cellules qu’il n’y a de colonnes.

Remarques

La Insert(Int32, DataGridViewRow) méthode ajoute une ligne partagée au DataGridViewRowCollection, si 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 à

Insert(Int32, Int32)

Insère le nombre de lignes spécifié dans la collection à l’emplacement spécifié.

public:
 virtual void Insert(int rowIndex, int count);
public virtual void Insert (int rowIndex, int count);
abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit
Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Paramètres

rowIndex
Int32

Position à laquelle insérer les lignes.

count
Int32

Nombre de lignes à insérer dans la DataGridViewRowCollection.

Exceptions

ArgumentOutOfRangeException

rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.

- ou -

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 dans le contrôle.

  • Suppression 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 -

rowIndex est égal au nombre de lignes dans la collection, et la propriété AllowUserToAddRows de DataGridView a la valeur true.

- 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 insérerait une ligne figée après des lignes non figées ou une ligne non figée avant des lignes figées.

Remarques

La Insert(Int32, Int32) méthode ajoute des lignes basées sur le RowTemplate de .DataGridView 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 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 à

Insert(Int32, Object[])

Insère une ligne dans la collection à la position spécifiée, et remplit les cellules avec les objets spécifiés.

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);
public virtual void Insert (int rowIndex, params object[] values);
abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit
Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Paramètres

rowIndex
Int32

Position à laquelle insérer la ligne.

values
Object[]

Nombre variable d’objets qui remplissent les cellules de la nouvelle ligne.

Exceptions

ArgumentOutOfRangeException

rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.

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 dans le contrôle.

  • Suppression 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 -

rowIndex est égal au nombre de lignes dans la collection, et la propriété AllowUserToAddRows de DataGridView a la valeur true.

- ou -

La propriété DataGridView de la ligne retournée par la propriété RowTemplate du contrôle n’a pas la valeur null.

- ou -

Cette opération insérerait une ligne figée après des lignes non figées ou une ligne non figée avant des lignes figées.

ArgumentException

La ligne retournée par la propriété RowTemplate du contrôle possède plus de cellules qu’il n’existe de colonnes dans le contrôle.

Remarques

La Insert(Int32, Object[]) méthode ajoute une ligne non partagée au DataGridViewRowCollection.

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 à