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 -> unitPublic 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 null oder größer als die Anzahl der Zeilen in der Auflistung minus 1.
- oder -
indexDestination ist kleiner als null oder größer als die Anzahl der Zeilen in der Auflistung.
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Zeilen hinzugefügt werden:
Markieren 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 ist gleich der Anzahl der Zeilen in der Auflistung und AllowUserToAddRows ist true.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht gesperrten Zeilen oder einer nicht gesperrten Zeile vor fixierten Zeilen eingefügt.
Hinweise
Diese Methode weist der im indexDestination Parameter angegebenen Index die neue Zeile zu und erhöht die Indizes für alle nachfolgenden Zeilen. Die InheritedStyle Eigenschaft des Neuen DataGridViewRow hat die gleichen Werte wie die InheritedStyle der DataGridViewRow positionierten .indexSource Die InsertCopy Methode fügt dem DataGridViewRowCollection, falls möglich, eine freigegebene Zeile hinzu. Andernfalls ist die neue Zeile nicht freigegeben. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die DataGridView.Sort Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der richtigen Position zu sortieren. Möglicherweise möchten Sie die DataGridView.Sort Methode auch in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.
