DataGridViewRowCollection.Add Methode

Definition

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

Gibt zurück

Der Index der neuen Zeile.

Ausnahmen

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.

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:

.NET Framework 4.8.1 und andere Versionen
Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Add(Int32)

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

public virtual int Add (int count);

Parameter

count
Int32

Die Anzahl der DataGridViewRowCollection hinzuzufügenden Zeilen.

Gibt zurück

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

Ausnahmen

count ist kleiner als 1.

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:

.NET Framework 4.8.1 und andere Versionen
Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Add(Object[])

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

public virtual int Add (params object[] values);

Parameter

values
Object[]

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

Gibt zurück

Der Index der neuen Zeile.

Ausnahmen

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

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:

.NET Framework 4.8.1 und andere Versionen
Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Add(DataGridViewRow)

Fügt der Auflistung den angegebenen DataGridViewRow hinzu.

public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);

Parameter

dataGridViewRow
DataGridViewRow

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

Gibt zurück

Der Index der neuen DataGridViewRow.

Ausnahmen

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.

dataGridViewRow ist null.

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:

.NET Framework 4.8.1 und andere Versionen
Produkt Versionen
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9