DataGridViewRowCollection.AddCopy(Int32) 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 nieuwe rij toe op basis van de rij in de opgegeven index.
public:
virtual int AddCopy(int indexSource);public virtual int AddCopy(int indexSource);abstract member AddCopy : int -> int
override this.AddCopy : int -> intPublic Overridable Function AddCopy (indexSource As Integer) As IntegerParameters
- indexSource
- Int32
De index van de rij waarop de nieuwe rij moet worden gebaseerd.
Retouren
De index van de nieuwe rij.
Uitzonderingen
indexSource is kleiner dan nul of groter dan of gelijk aan het aantal rijen in de verzameling.
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 –
Met deze bewerking wordt een geblokkeerde rij toegevoegd nadat de rijen zijn uitgeschakeld.
Opmerkingen
De InheritedStyle eigenschap van de nieuwe rij heeft dezelfde waarden als de InheritedStyle rij op indexSource. De AddCopy 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.
