DataGridViewRowCollection.IList.Insert(Int32, Object) 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 ein DataGridViewRow-Objekt am angegebenen Index in die Auflistung ein.
virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert
Parameter
- index
- Int32
Der nullbasierte Index, an dem value
eingefügt werden soll.
- value
- Object
Die DataGridViewRow, die in die DataGridViewRowCollection eingefügt werden soll.
Implementiert
Ausnahmen
value
ist keine DataGridViewRow.
index
ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.
value
ist null
.
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 -
index
ist gleich der Anzahl der Zeilen in der Auflistung, und die AllowUserToAddRows-Eigenschaft von DataGridView ist auf true
festgelegt.
- oder -
Die DataGridView hat keine Spalten.
- oder -
Die DataGridView-Eigenschaft der value
ist nicht null
.
- oder -
value
hat einen Selected-Eigenschaftswert von true
.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht fixierten Zeilen oder eine nicht fixierte Zeile vor fixierten Zeilen eingefügt.
value
enthält mehr Zellen als Spalten im Steuerelement vorhanden sind.
Hinweise
Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn die DataGridViewRowCollection-Instanz in eine IList-Schnittstelle umgewandelt wird.
Diese Methode ruft die Insert(Int32, DataGridViewRow) Überladung auf und übergibt den Wert nach der Umwandlung in ein DataGridViewRow.
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.