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 eine oder mehrere Zeilen in die Auflistung ein.
Überlädt
| Name | Beschreibung |
|---|---|
| Insert(Int32, DataGridViewRow) |
Fügt das 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 auf. |
Insert(Int32, DataGridViewRow)
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
Fügt das 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
The DataGridViewRow to insert into the DataGridViewRowCollection.
Ausnahmen
rowIndex ist kleiner als null oder größer als die Anzahl der Zeilen in der Auflistung.
dataGridViewRow 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 -
Die DataSource Eigenschaft der Eigenschaft DataGridView ist nicht null.
- oder -
rowIndexist gleich der Anzahl der Zeilen in der Auflistung und die AllowUserToAddRows Eigenschaft des DataGridView Werts auf .true
- oder -
Die Spalte DataGridView enthält 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 gesperrten Zeilen oder einer nicht gesperrten Zeile vor fixierten Zeilen eingefügt.
dataGridViewRow enthält mehr Zellen als Spalten im Steuerelement.
Hinweise
Die Insert(Int32, 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
Gilt für:
Insert(Int32, Int32)
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
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 DataGridViewRowCollectionEinfügemarke eingefügt werden sollen.
Ausnahmen
rowIndex ist kleiner als null oder größer als die Anzahl der Zeilen in der Auflistung.
- oder -
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 -
rowIndexist gleich der Anzahl der Zeilen in der Auflistung und die AllowUserToAddRows Eigenschaft des DataGridView Werts auf .true
- 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 oder einer nicht gesperrten Zeile vor fixierten Zeilen eingefügt.
Hinweise
Die Insert(Int32, Int32) Methode 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
Gilt für:
Insert(Int32, Object[])
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
- Quelle:
- DataGridViewRowCollection.cs
Fügt eine Zeile an der angegebenen Position in die Auflistung ein und füllt die Zellen mit den angegebenen Objekten auf.
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 auffüllen.
Ausnahmen
rowIndex ist kleiner als null oder größer als die Anzahl der Zeilen in der Auflistung.
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 -
rowIndexist gleich der Anzahl der Zeilen in der Auflistung und die AllowUserToAddRows Eigenschaft des DataGridView Werts auf .true
- oder -
Die DataGridView Eigenschaft der Zeile, die von der Eigenschaft des Steuerelements RowTemplate zurückgegeben wird, ist nicht null.
- oder -
Bei diesem Vorgang würde eine fixierte Zeile nach nicht gesperrten Zeilen oder einer nicht gesperrten Zeile vor fixierten Zeilen eingefügt.
Die von der Eigenschaft des Steuerelements RowTemplate zurückgegebene Zeile weist mehr Zellen auf, als spalten im Steuerelement vorhanden sind.
Hinweise
Die Insert(Int32, Object[]) Methode fügt der DataGridViewRowCollectionMethode eine nicht gespeicherte Zeile hinzu.
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.
