Teilen über


DataGridViewRowCollection.Insert Methode

Definition

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 -> unit
Public 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 -> unit
Public 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[] -> unit
Public 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.

Weitere Informationen

Gilt für: