DataGridViewRowCollection.Add Methode
Definition
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.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 Wert hinzu. |
Add()
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
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 -> intPublic Overridable Function Add () As IntegerGibt zurück
Der Index der neuen Zeile.
Ausnahmen
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Zeilen hinzugefügt werden:
Markieren 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 Eigenschaft DataGridView ist nicht null.
- oder -
Die Spalte DataGridView enthält keine Spalten.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht gesperrten Zeilen hinzugefügt.
Die von der RowTemplate Eigenschaft zurückgegebene Zeile weist mehr Zellen auf, als spalten im Steuerelement vorhanden sind.
Hinweise
Die Add() Überladung fügt Zeilen hinzu, die auf dem RowTemplateDataGridViewdes . Die neue Zeile wird nach Möglichkeit freigegeben. Stellen Sie sicher, dass die in der RowTemplate Eigenschaft angegebene Zeile für optimale Skalierbarkeit freigegeben werden kann. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die DataGridView.Sort Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der richtigen Position zu sortieren. Möglicherweise möchten Sie die DataGridView.Sort Methode auch in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.
Weitere Informationen
- DataGridView
- DataGridViewRow
- Bewährte Methoden für die Skalierung des Windows Forms DataGridView-Steuerelements
Gilt für:
Add(Int32)
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
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 -> intPublic Overridable Function Add (count As Integer) As IntegerParameter
- count
- Int32
Die Anzahl der Zeilen, die DataGridViewRowCollectiondem Hinzugefügt werden sollen.
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, die vorübergehend verhindern, dass neue Zeilen hinzugefügt werden:
Markieren 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 Eigenschaft DataGridView ist nicht null.
- oder -
Die Spalte DataGridView enthält keine Spalten.
- oder -
Die von der RowTemplate Eigenschaft zurückgegebene Zeile weist mehr Zellen auf, als spalten im Steuerelement vorhanden sind.
- oder -
Bei diesem Vorgang würden fixierte Zeilen nach nicht gesperrten Zeilen hinzugefügt.
Hinweise
Die Add(Int32) Methode fügt freigegebene Zeilen zu der DataGridViewRowCollection. Die neuen Zeilen basieren auf dem RowTemplate des DataGridView. Stellen Sie sicher, dass die in der RowTemplate Eigenschaft angegebene Zeile für optimale Skalierbarkeit freigegeben werden kann. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die DataGridView.Sort Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der richtigen Position zu sortieren. Möglicherweise möchten Sie die DataGridView.Sort Methode auch in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.
Weitere Informationen
Gilt für:
Add(Object[])
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
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[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParameter
- values
- Object[]
Eine variable Anzahl von Objekten, die die Zellen der neuen DataGridViewRowauffüllen.
Gibt zurück
Der Index der neuen Zeile.
Ausnahmen
values ist null.
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Zeilen hinzugefügt werden:
Markieren 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 Eigenschaft DataGridView ist nicht null.
- oder -
Die Spalte DataGridView enthält keine Spalten.
- oder -
Die von der RowTemplate Eigenschaft zurückgegebene Zeile weist mehr Zellen auf, als spalten im Steuerelement vorhanden sind.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht gesperrten Zeilen hinzugefügt.
Hinweise
Die Add(Object[]) Methode fügt der DataGridViewRowCollectionMethode eine nicht gespeicherte Zeile hinzu. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die DataGridView.Sort Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der richtigen Position zu sortieren. Möglicherweise möchten Sie die DataGridView.Sort Methode auch in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.
Weitere Informationen
Gilt für:
Add(DataGridViewRow)
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
Fügt der Auflistung den angegebenen DataGridViewRow Wert 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 -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParameter
- dataGridViewRow
- DataGridViewRow
Der DataGridViewRow zum Hinzufügen zu der DataGridViewRowCollection.
Gibt zurück
Der Index des neuen DataGridViewRow.
Ausnahmen
Das zugeordnete DataGridView Steuerelement führt eine der folgenden Aktionen aus, die vorübergehend verhindern, dass neue Zeilen hinzugefügt werden:
Markieren 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 Eigenschaft DataGridView ist nicht null.
- oder -
Die Spalte DataGridView enthält keine Spalten.
- oder -
Die DataGridView Eigenschaft der Eigenschaft dataGridViewRow ist nicht null.
- oder -
dataGridViewRow hat einen Selected Eigenschaftswert von true.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht gesperrten Zeilen hinzugefügt.
dataGridViewRow ist null.
dataGridViewRow enthält mehr Zellen als Spalten im Steuerelement.
Hinweise
Die Add(DataGridViewRow) Methode fügt dem DataGridViewRowCollection, falls möglich, eine freigegebene Zeile hinzu. Andernfalls ist die neue Zeile nicht freigegeben. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Zeilen im Steuerelement werden nicht automatisch sortiert, wenn neue Zeilen hinzugefügt werden. Rufen Sie die DataGridView.Sort Methode in einem DataGridView.RowsAdded Ereignishandler auf, um neue Zeilen an der richtigen Position zu sortieren. Möglicherweise möchten Sie die DataGridView.Sort Methode auch in einem CellValueChanged Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.
Weitere Informationen
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Bewährte Methoden für die Skalierung des Windows Forms DataGridView-Steuerelements
