DataGridViewRowCollection.IList.Insert(Int32, Object) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Insert(Int32, Object)

Ausnahmen

InvalidCastException

value ist keine DataGridViewRow.

ArgumentOutOfRangeException

index ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.

ArgumentNullException

value ist null.

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:

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

ArgumentException

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.

Gilt für:

Weitere Informationen