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

– Aufheben der Auswahl.

- 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 Schnittstellenelementimplementierung. Er kann nur verwendet werden, wenn die DataGridViewRowCollection-Instanz in eine IList-Schnittstelle umgewandelt wird.

Diese Methode ruft die Add(DataGridViewRow) Überladung auf, die value nach der Umwandlung an eine DataGridViewRow.

Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der DataGridView.Sort richtigen Position zu sortieren. 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:

Siehe auch