Freigeben über


DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Methode

Definition

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

Gilt für:

Weitere Informationen