DataGridViewRowCollection.Insert 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
| Insert(Int32, DataGridViewRow) |
Fügt die angegebene DataGridViewRow in die Auflistung ein. |
| Insert(Int32, Int32) |
Fügt die angegebene Anzahl von Zeilen an der angegebenen Position in die Auflistung ein. |
| Insert(Int32, Object[]) |
Fügt eine Zeile an der angegebenen Position in die Auflistung ein und füllt die Zellen mit den angegebenen Objekten. |
Insert(Int32, DataGridViewRow)
Fügt die angegebene DataGridViewRow in die Auflistung ein.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Parameter
- rowIndex
- Int32
Die Position, an der die Zeile eingefügt werden soll.
- dataGridViewRow
- DataGridViewRow
Die DataGridViewRow, die in die DataGridViewRowCollection eingefügt werden soll.
Ausnahmen
rowIndex ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.
dataGridViewRow 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 -
Die DataSource-Eigenschaft der DataGridView ist nicht null.
- oder -
rowIndex ist gleich der Anzahl der Zeilen in der Auflistung, und die AllowUserToAddRows-Eigenschaft von DataGridView ist auf true festgelegt.
- oder -
Die DataGridView hat keine Spalten.
- oder -
Die DataGridView-Eigenschaft von dataGridViewRow ist nicht null.
- oder -
dataGridViewRow hat einen Selected-Eigenschaftswert von true.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht fixierten Zeilen oder eine nicht fixierte Zeile vor fixierten Zeilen eingefügt.
dataGridViewRow enthält mehr Zellen als Spalten im Steuerelement vorhanden sind.
Hinweise
Die Insert(Int32, 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:
Insert(Int32, Int32)
Fügt die angegebene Anzahl von Zeilen an der angegebenen Position in die Auflistung ein.
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Parameter
- rowIndex
- Int32
Die Position, an der die Zeilen eingefügt werden sollen.
- count
- Int32
Die Anzahl der Zeilen, die in die DataGridViewRowCollection eingefügt werden sollen.
Ausnahmen
rowIndex ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.
- oder -
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 -
rowIndex ist gleich der Anzahl der Zeilen in der Auflistung, und die AllowUserToAddRows-Eigenschaft von DataGridView ist auf true festgelegt.
- oder -
Die von der RowTemplate-Eigenschaft zurückgegebene Zeile hat mehr Zellen als das Steuerelement Spalten aufweist.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht fixierten Zeilen oder eine nicht fixierte Zeile vor fixierten Zeilen eingefügt.
Hinweise
Die Insert(Int32, Int32) -Methode fügt Zeilen hinzu, die auf dem RowTemplate von 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:
Insert(Int32, Object[])
Fügt eine Zeile an der angegebenen Position in die Auflistung ein und füllt die Zellen mit den angegebenen Objekten.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Parameter
- rowIndex
- Int32
Die Position, an der die Zeile eingefügt werden soll.
- values
- Object[]
Eine variable Anzahl von Objekten, die die Zellen der neuen Zeile füllen.
Ausnahmen
rowIndex ist kleiner als 0 (null) oder größer als die Anzahl von Zeilen in der Auflistung.
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 -
rowIndex ist gleich der Anzahl der Zeilen in der Auflistung, und die AllowUserToAddRows-Eigenschaft von DataGridView ist auf true festgelegt.
- oder -
Die DataGridView-Eigenschaft der Zeile, die von der RowTemplate-Eigenschaft des Steuerelements zurückgegeben wird, ist nicht gleich null.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht fixierten Zeilen oder eine nicht fixierte Zeile vor fixierten Zeilen eingefügt.
Die von der RowTemplate-Eigenschaft des Steuerelements zurückgegebene Zeile hat mehr Zellen als das Steuerelement Spalten hat.
Hinweise
Die Insert(Int32, Object[]) -Methode fügt dem eine nicht freigegebene Zeile hinzu DataGridViewRowCollection.
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.
