Freigeben über


DataGridViewRowCollection.InsertCopy(Int32, Int32) Methode

Definition

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.

Gilt für:

Weitere Informationen