DataGridViewRowCollection.Add Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Auflistung eine oder mehrere Zeilen hinzu.
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. |
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
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
- DataGridView
- DataGridViewRow
- Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms
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 |
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
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 |
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
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 |
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
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
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms
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 |
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: