DataGridViewRowCollection.InsertCopies(Int32, 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 rijen in de verzameling in op de opgegeven positie.
public:
virtual void InsertCopies(int indexSource, int indexDestination, int count);public virtual void InsertCopies(int indexSource, int indexDestination, int count);abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)Parameters
- indexSource
- Int32
De index van de DataGridViewRow waarop de nieuwe rijen moeten worden gebaseerd.
- indexDestination
- Int32
De positie waarop de rijen moeten worden ingevoegd.
- count
- Int32
Het aantal DataGridViewRow objecten dat moet worden toegevoegd aan de DataGridViewRowCollection.
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.
– 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 –
indexDestination is gelijk aan het aantal rijen in de verzameling en AllowUserToAddRows is true.
– of –
Met deze bewerking worden geblokkeerde rijen ingevoegd nadat rijen zijn uitgeschakeld of rijen die niet zijn bevroren voor geblokkeerde rijen.
Opmerkingen
De InheritedStyle eigenschap van de nieuwe DataGridViewRow objecten heeft dezelfde waarden als de InheritedStyle waarde van de DataGridViewRow positie op indexSource. Met de InsertCopies methode worden gedeelde rijen toegevoegd aan de DataGridViewRowCollection, indien mogelijk. Anders worden de nieuwe rijen 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.
