DataGridViewRowCollection.Insert Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.
dataGridViewRow 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 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.
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 -> unitPublic 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
rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.
- ou -
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 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[] -> unitPublic 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
rowIndex est inférieur à zéro ou supérieur au nombre de lignes dans la collection.
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 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.
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.
