DataGridViewRowCollection.Add 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.
Voegt een of meer rijen toe aan de verzameling.
Overloads
| Name | Description |
|---|---|
| Add() |
Voegt een nieuwe rij toe aan de verzameling. |
| Add(Int32) |
Hiermee voegt u het opgegeven aantal nieuwe rijen toe aan de verzameling. |
| Add(Object[]) |
Voegt een nieuwe rij toe aan de verzameling en vult de cellen met de opgegeven objecten. |
| Add(DataGridViewRow) |
Voegt de opgegeven DataGridViewRow waarde toe aan de verzameling. |
Add()
Voegt een nieuwe rij toe aan de verzameling.
public:
virtual int Add();public virtual int Add();abstract member Add : unit -> int
override this.Add : unit -> intPublic Overridable Function Add () As IntegerRetouren
De index van de nieuwe rij.
Uitzonderingen
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 –
Met deze bewerking wordt een geblokkeerde rij toegevoegd nadat de rijen zijn uitgeschakeld.
De rij die door de RowTemplate eigenschap wordt geretourneerd, bevat meer cellen dan er kolommen in het besturingselement zijn.
Opmerkingen
De Add() overbelasting voegt rijen toe 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
- DataGridView
- DataGridViewRow
- Aanbevolen procedures voor het schalen van het Besturingselement Windows Forms DataGridView
Van toepassing op
Add(Int32)
Hiermee voegt u het opgegeven aantal nieuwe rijen toe aan de verzameling.
public:
virtual int Add(int count);public virtual int Add(int count);abstract member Add : int -> int
override this.Add : int -> intPublic Overridable Function Add (count As Integer) As IntegerParameters
- count
- Int32
Het aantal rijen dat moet worden toegevoegd aan de DataGridViewRowCollection.
Retouren
De index van de laatste rij die is toegevoegd.
Uitzonderingen
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 –
De rij die door de RowTemplate eigenschap wordt geretourneerd, bevat meer cellen dan er kolommen in het besturingselement zijn.
– of –
Met deze bewerking worden geblokkeerde rijen toegevoegd nadat de rijen zijn uitgeschakeld.
Opmerkingen
Met de Add(Int32) methode worden gedeelde rijen aan de DataGridViewRowCollectionmethode toegevoegd. De nieuwe rijen zijn gebaseerd op de RowTemplateDataGridView. 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
Add(Object[])
Voegt een nieuwe rij toe aan de verzameling en vult de cellen met de opgegeven objecten.
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[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParameters
- values
- Object[]
Een variabel aantal objecten dat de cellen van het nieuwe DataGridViewRowobject vult.
Retouren
De index van de nieuwe rij.
Uitzonderingen
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 –
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 toegevoegd nadat de rijen zijn uitgeschakeld.
Opmerkingen
Met de Add(Object[]) methode wordt een niet-gedeelde rij toegevoegd aan de DataGridViewRowCollection. 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
Add(DataGridViewRow)
Voegt de opgegeven DataGridViewRow waarde toe aan de verzameling.
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 -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParameters
- dataGridViewRow
- DataGridViewRow
De DataGridViewRow toe te voegen aan de DataGridViewRowCollection.
Retouren
De index van de nieuwe DataGridViewRow.
Uitzonderingen
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 –
De DataGridView eigenschap van het dataGridViewRow is niet null.
– of –
dataGridViewRow heeft een Selected eigenschapswaarde van true.
– of –
Met deze bewerking wordt een geblokkeerde rij toegevoegd nadat de rijen zijn uitgeschakeld.
dataGridViewRow is null.
dataGridViewRow heeft meer cellen dan er kolommen in het besturingselement zijn.
Opmerkingen
De Add(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
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Aanbevolen procedures voor het schalen van het Besturingselement Windows Forms DataGridView
