Teilen über

DataGridViewRowCollection.Add Methode

  • Referenz

Definition

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

Fügt der Auflistung eine oder mehrere Zeilen hinzu.

Überlädt

Add()

Fügt der Auflistung eine neue Zeile hinzu.
Add(Int32)

Fügt der Auflistung die angegebene Anzahl neuer Zeilen hinzu.
Add(Object[])

Fügt der Auflistung eine neue Zeile hinzu und füllt die Zellen mit den angegebenen Objekten auf.
Add(DataGridViewRow)

Fügt der Auflistung den angegebenen DataGridViewRow hinzu.

Add()

Fügt der Auflistung eine neue Zeile hinzu.

public:
 virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer

Gibt zurück

Int32

Der Index der neuen Zeile.

Ausnahmen

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 -

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

ArgumentException

Die von der RowTemplate-Eigenschaft zurückgegebene Zeile hat mehr Zellen als das Steuerelement Spalten aufweist.

Hinweise

Die Add() Überladung fügt Zeilen hinzu, die auf dem RowTemplate des DataGridViewbasieren. Die neue Zeile wird nach Möglichkeit freigegeben. Stellen Sie sicher, dass die in der RowTemplate -Eigenschaft angegebene Zeile zur optimalen Skalierbarkeit freigegeben werden kann. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

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.

Weitere Informationen

Gilt für:

Add(Int32)

Fügt der Auflistung die angegebene Anzahl neuer Zeilen hinzu.

public:
 virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer

Parameter

count
Int32

Die Anzahl der DataGridViewRowCollection hinzuzufügenden Zeilen.

Gibt zurück

Int32

Der Index der letzten Zeile, die hinzugefügt wurde.

Ausnahmen

ArgumentOutOfRangeException

count ist kleiner als 1.

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 von der RowTemplate-Eigenschaft zurückgegebene Zeile hat mehr Zellen als das Steuerelement Spalten aufweist.

- oder -

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

Hinweise

Die Add(Int32) -Methode fügt der freigegebene DataGridViewRowCollectionZeilen hinzu. Die neuen Zeilen basieren auf dem RowTemplate von DataGridView. Stellen Sie sicher, dass die in der RowTemplate -Eigenschaft angegebene Zeile zur optimalen Skalierbarkeit freigegeben werden kann. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

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.

Weitere Informationen

Gilt für:

Add(Object[])

Fügt der Auflistung eine neue Zeile hinzu und füllt die Zellen mit den angegebenen Objekten auf.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

Parameter

values
Object[]

Eine variable Anzahl von Objekten, die die Zellen der neuen DataGridViewRow auffüllen.

Gibt zurück

Int32

Der Index der neuen Zeile.

Ausnahmen

ArgumentNullException

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

Für die Eigenschaft VirtualMode des DataGridView wird der Wert true festgelegt.

- oder -

Die DataSource-Eigenschaft der DataGridView ist nicht null.

- oder -

Die DataGridView hat keine Spalten.

- oder -

Die von der RowTemplate-Eigenschaft zurückgegebene Zeile hat mehr Zellen als das Steuerelement Spalten aufweist.

- oder -

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

Hinweise

Die Add(Object[]) -Methode fügt dem eine nicht freigegebene Zeile hinzu DataGridViewRowCollection. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

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.

Weitere Informationen

Gilt für:

Add(DataGridViewRow)

Fügt der Auflistung den angegebenen DataGridViewRow hinzu.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Parameter

dataGridViewRow
DataGridViewRow

Das DataGridViewRow, das in DataGridViewRowCollection eingefügt werden soll.

Gibt zurück

Int32

Der Index der neuen DataGridViewRow.

Ausnahmen

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 dataGridViewRow ist nicht null.

- oder -

dataGridViewRow hat einen Selected-Eigenschaftswert von true.

- oder -

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

ArgumentNullException

dataGridViewRow ist null.

ArgumentException

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

Hinweise

Die Add(DataGridViewRow) -Methode fügt nach DataGridViewRowCollectionMöglichkeit eine freigegebene Zeile zu hinzu. Andernfalls wird die Freigabe der neuen Zeile aufgehoben. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

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.

Weitere Informationen

Gilt für: