DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt Zeilen an der angegebenen Position in die Auflistung ein.
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 -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)
Parameter
- indexSource
- Int32
Der Index der DataGridViewRow, auf der die neuen Zeilen basieren sollen.
- indexDestination
- Int32
Die Position, an der die Zeilen eingefügt werden sollen.
- count
- Int32
Die Anzahl von DataGridViewRow-Objekten, die zur DataGridViewRowCollection hinzugefügt werden sollen.
Ausnahmen
indexSource
ist kleiner als 0 (null) oder größer als die Anzahl der Zeilen in der Auflistung minus 1.
- oder -
indexDestination
ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.
- oder -
count
ist kleiner als 1.
Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen aus, wodurch vorübergehend keine neuen Zeilen hinzugefügt werden können:
Auswählen aller Zellen im Steuerelement.
Die Auswahl wird gelöscht.
- oder -
Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:
- oder -
indexDestination
entspricht der Anzahl der Zeilen in der Auflistung und AllowUserToAddRows ist true
.
- oder -
Bei diesem Vorgang würden fixierte Zeilen nach nicht fixierten Zeilen oder nicht fixierte Zeilen vor fixierten Zeilen eingefügt.
Hinweise
Die InheritedStyle -Eigenschaft der neuen DataGridViewRow -Objekte weist die gleichen Werte auf wie der DataGridViewRowInheritedStyle von in indexSource
positioniert. Die InsertCopies -Methode fügt nach Möglichkeit freigegebene DataGridViewRowCollectionZeilen hinzu. Andernfalls werden die neuen Zeilen aufgehoben. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Um neue Zeilen an die richtige Position zu sortieren, rufen Sie die DataGridView.Sort -Methode in einem Ereignishandler auf DataGridView.RowsAdded . Sie können auch die DataGridView.Sort Methode in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.