DataGridViewRowCollection.Insert Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een of meer rijen in de verzameling in.
Overloads
| Name | Description |
|---|---|
| Insert(Int32, DataGridViewRow) |
Hiermee voegt u de opgegeven DataGridViewRow in de verzameling in. |
| Insert(Int32, Int32) |
Hiermee voegt u het opgegeven aantal rijen in de verzameling in op de opgegeven locatie. |
| Insert(Int32, Object[]) |
Hiermee wordt een rij ingevoegd in de verzameling op de opgegeven positie en worden de cellen gevuld met de opgegeven objecten. |
Insert(Int32, DataGridViewRow)
Hiermee voegt u de opgegeven DataGridViewRow in de verzameling in.
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)Parameters
- rowIndex
- Int32
De positie waarop de rij moet worden ingevoegd.
- dataGridViewRow
- DataGridViewRow
De DataGridViewRow invoegpositie in de DataGridViewRowCollection.
Uitzonderingen
rowIndex is kleiner dan nul of groter dan het aantal rijen in de verzameling.
dataGridViewRow is null.
Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit die tijdelijk verhinderen dat nieuwe rijen worden toegevoegd:
Alle cellen in het besturingselement selecteren.
De selectie wissen.
– of –
Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:
– of –
De DataSource eigenschap van het DataGridView is niet null.
– of –
rowIndex is gelijk aan het aantal rijen in de verzameling en de AllowUserToAddRows eigenschap van de DataGridView verzameling is ingesteld op true.
– of –
De DataGridView kolom heeft geen kolommen.
– of –
De DataGridView eigenschap van dataGridViewRow is niet null.
– of –
dataGridViewRow heeft een Selected eigenschapswaarde van true.
– of –
Met deze bewerking wordt een geblokkeerde rij ingevoegd na het opheffen van rijen of een niet-bevroren rij voor geblokkeerde rijen.
dataGridViewRow heeft meer cellen dan er kolommen in het besturingselement zijn.
Opmerkingen
De Insert(Int32, DataGridViewRow) methode voegt indien mogelijk een gedeelde rij toe aan de DataGridViewRowCollection, indien mogelijk. Anders wordt de nieuwe rij niet gedeeld. Zie Best practices voor het schalen van het Windows Forms DataGridView-besturingselement voor meer informatie.
Rijen in het besturingselement worden niet automatisch gesorteerd wanneer er nieuwe rijen worden toegevoegd. Als u nieuwe rijen in de juiste positie wilt sorteren, roept u de DataGridView.Sort methode aan in een DataGridView.RowsAdded gebeurtenis-handler. U kunt ook de DataGridView.Sort methode aanroepen in een CellValueChanged gebeurtenishandler om de rijen te sorteren wanneer de gebruiker een cel wijzigt.
Zie ook
Van toepassing op
Insert(Int32, Int32)
Hiermee voegt u het opgegeven aantal rijen in de verzameling in op de opgegeven locatie.
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)Parameters
- rowIndex
- Int32
De positie waarop de rijen moeten worden ingevoegd.
- count
- Int32
Het aantal rijen dat moet worden ingevoegd in de DataGridViewRowCollection.
Uitzonderingen
rowIndex is kleiner dan nul of groter dan het aantal rijen in de verzameling.
– of –
count is kleiner dan 1.
Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit die tijdelijk verhinderen dat nieuwe rijen worden toegevoegd:
Alle cellen in het besturingselement selecteren.
De selectie wissen.
– of –
Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:
– of –
De DataSource eigenschap van het DataGridView is niet null.
– of –
De DataGridView kolom heeft geen kolommen.
– of –
rowIndex is gelijk aan het aantal rijen in de verzameling en de AllowUserToAddRows eigenschap van de DataGridView verzameling is ingesteld op true.
– of –
De rij die door de RowTemplate eigenschap wordt geretourneerd, bevat meer cellen dan er kolommen in het besturingselement zijn.
– of –
Met deze bewerking wordt een geblokkeerde rij ingevoegd na het opheffen van rijen of een niet-bevroren rij voor geblokkeerde rijen.
Opmerkingen
Met Insert(Int32, Int32) de methode worden rijen toegevoegd die zijn gebaseerd op de RowTemplateDataGridView. De nieuwe rij wordt, indien mogelijk, gedeeld. Zorg ervoor dat de rij die is opgegeven in de RowTemplate eigenschap, kan worden gedeeld voor de beste schaalbaarheid. Zie Best practices voor het schalen van het Windows Forms DataGridView-besturingselement voor meer informatie.
Rijen in het besturingselement worden niet automatisch gesorteerd wanneer er nieuwe rijen worden toegevoegd. Als u nieuwe rijen in de juiste positie wilt sorteren, roept u de DataGridView.Sort methode aan in een DataGridView.RowsAdded gebeurtenis-handler. U kunt ook de DataGridView.Sort methode aanroepen in een CellValueChanged gebeurtenishandler om de rijen te sorteren wanneer de gebruiker een cel wijzigt.
Zie ook
Van toepassing op
Insert(Int32, Object[])
Hiermee wordt een rij ingevoegd in de verzameling op de opgegeven positie en worden de cellen gevuld met de opgegeven objecten.
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())Parameters
- rowIndex
- Int32
De positie waarop de rij moet worden ingevoegd.
- values
- Object[]
Een variabel aantal objecten dat de cellen van de nieuwe rij vult.
Uitzonderingen
rowIndex is kleiner dan nul of groter dan het aantal rijen in de verzameling.
values is null.
Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit die tijdelijk verhinderen dat nieuwe rijen worden toegevoegd:
Alle cellen in het besturingselement selecteren.
De selectie wissen.
– of –
Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:
– of –
De VirtualMode eigenschap van de DataGridView is ingesteld op true.
– of –
De DataSource eigenschap van het DataGridView is niet null.
– of –
De DataGridView kolom heeft geen kolommen.
– of –
rowIndex is gelijk aan het aantal rijen in de verzameling en de AllowUserToAddRows eigenschap van de DataGridView verzameling is ingesteld op true.
– of –
De DataGridView eigenschap van de rij die wordt geretourneerd door de eigenschap van RowTemplate het besturingselement is niet null.
– of –
Met deze bewerking wordt een geblokkeerde rij ingevoegd na het opheffen van rijen of een niet-bevroren rij voor geblokkeerde rijen.
De rij die wordt geretourneerd door de eigenschap van RowTemplate het besturingselement bevat meer cellen dan er kolommen in het besturingselement zijn.
Opmerkingen
Met de Insert(Int32, Object[]) methode wordt een niet-gedeelde rij toegevoegd aan de DataGridViewRowCollection.
Rijen in het besturingselement worden niet automatisch gesorteerd wanneer er nieuwe rijen worden toegevoegd. Als u nieuwe rijen in de juiste positie wilt sorteren, roept u de DataGridView.Sort methode aan in een DataGridView.RowsAdded gebeurtenis-handler. U kunt ook de DataGridView.Sort methode aanroepen in een CellValueChanged gebeurtenishandler om de rijen te sorteren wanneer de gebruiker een cel wijzigt.
