DataGridViewRowCollection.Insert Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Insère une ou plusieurs lignes dans la collection.

Surcharges

Nom	Description
Insert(Int32, DataGridViewRow)	Insère le spécifié DataGridViewRow 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)

Source:

DataGridViewRowCollection.cs

Insère le spécifié DataGridViewRow 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

À DataGridViewRow insérer dans le DataGridViewRowCollection.

Exceptions

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow 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 DataSource propriété de l’objet DataGridView n’est pas null.

- ou -

rowIndex est égal au nombre de lignes de la collection et la AllowUserToAddRows propriété du fichier DataGridView est définie truesur .

- ou -

Il DataGridView n’y a pas de colonnes.

- ou -

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

- ou -

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

- ou -

Cette opération insère une ligne figée après les lignes non figées ou une ligne non vide avant les lignes figées.

ArgumentException

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

Remarques

La Insert(Int32, 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

Insert(Int32, Int32)

Source:

DataGridViewRowCollection.cs

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

Exceptions

ArgumentOutOfRangeException

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

- ou -

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 -

rowIndex est égal au nombre de lignes de la collection et la AllowUserToAddRows propriété du fichier DataGridView est définie truesur .

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

Remarques

La Insert(Int32, Int32) méthode 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

Insert(Int32, Object[])

Source:

DataGridViewRowCollection.cs

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 de la collection.

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 -

rowIndex est égal au nombre de lignes de la collection et la AllowUserToAddRows propriété du fichier DataGridView est définie truesur .

- ou -

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

- ou -

Cette opération insère une ligne figée après les lignes non figées ou une ligne non vide avant les lignes figées.

ArgumentException

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

Remarques

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

• DataGridView
• DataGridViewRow