DataGridViewRowCollection.InsertCopy(Int32, 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 rij in de verzameling op de opgegeven positie in op basis van de rij op de opgegeven positie.
public:
virtual void InsertCopy(int indexSource, int indexDestination);public virtual void InsertCopy(int indexSource, int indexDestination);abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unitPublic Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)Parameters
- indexSource
- Int32
De index van de rij waarop de nieuwe rij moet worden gebaseerd.
- indexDestination
- Int32
De positie waarop de rij moet worden ingevoegd.
Uitzonderingen
indexSource is kleiner dan nul of groter dan het aantal rijen in de verzameling min één.
– of –
indexDestination is kleiner dan nul of groter dan 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 –
indexDestination is gelijk aan het aantal rijen in de verzameling en AllowUserToAddRows is true.
– of –
Met deze bewerking wordt een geblokkeerde rij ingevoegd na het opheffen van rijen of een niet-bevroren rij voor geblokkeerde rijen.
Opmerkingen
Met deze methode wordt de nieuwe rij toegewezen aan de index die is opgegeven in de indexDestination parameter en worden de indexen voor alle volgende rijen verhoogd. De InheritedStyle eigenschap van de nieuwe DataGridViewRow heeft dezelfde waarden als de InheritedStyleDataGridViewRow positie indexSourceop . De InsertCopy 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.
