DataGridViewRowCollection.InsertCopy(Int32, Int32) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

ArgumentOutOfRangeException

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.

InvalidOperationException

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:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 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.

Weitere Informationen

• DataGridView
• DataGridViewRow