DataGridViewRowCollection.InsertCopy(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 eine Zeile an der angegebenen Position basierend auf der Zeile an der angegebenen Position in die Auflistung ein.
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 -> unit
Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)
Parameter
- indexSource
- Int32
Der Index der Zeile, auf der die neue Zeile basieren soll.
- indexDestination
- Int32
Die Position, an der die Zeile eingefügt werden soll.
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.
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ürde eine fixierte Zeile nach nicht fixierten Zeilen oder eine nicht fixierte Zeile vor fixierten Zeilen eingefügt.
Hinweise
Diese Methode weist der neuen Zeile den im indexDestination
Parameter angegebenen Index zu und erhöht die Indizes für alle nachfolgenden Zeilen. Die InheritedStyle Eigenschaft des neuen DataGridViewRow weist die gleichen Werte auf wie der InheritedStyle von DataGridViewRow in positioniert.indexSource
Die InsertCopy -Methode fügt nach Möglichkeit eine freigegebene DataGridViewRowCollectionZeile hinzu. Andernfalls wird die neue Zeile 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.