Teilen über


DataGridViewRowCollection.AddCopy(Int32) Methode

Definition

Fügt auf Basis der Zeile, die den angegebenen Index hat, eine neue Zeile hinzu.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

Parameter

indexSource
Int32

Der Index der Zeile, auf der die neue Zeile basieren soll.

Gibt zurück

Der Index der neuen Zeile.

Ausnahmen

indexSource ist kleiner als 0 (null) oder größer gleich der 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 -

Die DataSource-Eigenschaft der DataGridView ist nicht null.

- oder -

Dieser Vorgang würde eine fixierte Zeile hinter nicht fixierten Zeilen hinzufügen.

Hinweise

Die InheritedStyle -Eigenschaft der neuen Zeile hat dieselben Werte wie die InheritedStyle der Zeile, die in indexSourcepositioniert ist. Die AddCopy -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