DataGridViewRowCollection.IList.Add(Object) Methode

  • Referenz

Definition

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

Fügt der Auflistung eine DataGridViewRow hinzu.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parameter

value
Object

Das Object, das in IList eingefügt werden soll.

Gibt zurück

Int32

Der Index der neuen DataGridViewRow.

Implementiert

Add(Object)

Ausnahmen

InvalidCastException

value ist keine DataGridViewRow.

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 -

Die DataGridView hat keine Spalten.

- oder -

Die DataGridView-Eigenschaft der value ist nicht null.

- oder -

value hat einen Selected-Eigenschaftswert von true.

- oder -

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

ArgumentNullException

value ist null.

ArgumentException

value enthält mehr Zellen als Spalten im Steuerelement vorhanden sind.

Hinweise

Diese Methode ist eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn die DataGridViewRowCollection-Instanz in eine IList-Schnittstelle umgewandelt wird.

Diese Methode ruft die Add(DataGridViewRow) -Überladung auf und übergibt value sie 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 DataGridView.RowsAdded Ereignishandler auf. Möglicherweise möchten Sie 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