Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

DataGridViewRowCollection.InsertCopies-Methode

Fügt Zeilen an der angegebenen Position in die Auflistung ein.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public virtual void InsertCopies (
	int indexSource,
	int indexDestination,
	int count
)
public void InsertCopies (
	int indexSource, 
	int indexDestination, 
	int count
)
public function InsertCopies (
	indexSource : int, 
	indexDestination : int, 
	count : int
)
Nicht zutreffend.

Parameter

indexSource

Der Index der DataGridViewRow, auf der die neuen Zeilen basieren sollen.

indexDestination

Die Position, an der die Zeilen eingefügt werden soll.

count

Die Anzahl der DataGridViewRow-Objekte, die der DataGridViewRowCollection hinzugefügt werden sollen.

AusnahmetypBedingung

ArgumentOutOfRangeException

indexSource ist kleiner als 0 (null) oder größer als die Anzahl der Zeilen in der Auflistung minus eins.

- oder -

indexDestination ist kleiner als 0 (null) oder größer als die Anzahl der Zeilen in der Auflistung.

- oder -

count ist kleiner als 1.

InvalidOperationException

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Zeilen verhindert:

  • Auswählen aller Zellen im Steuerelement.

  • Aufheben der Auswahl.

- oder -

Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:

- oder -

indexDestination ist gleich der Anzahl von Zeilen in der Auflistung, und DataGridView.AllowUserToAddRows ist true.

- oder -

Diese Operation würde fixierte Zeilen nach nicht fixierten Zeilen oder nicht fixierte Zeilen vor fixierten Zeilen einfügen.

Die InheritedStyle-Eigenschaft der neuen DataGridViewRow-Objekte verfügt über dieselben Werte wie der InheritedStyle der DataGridViewRow an der Position indexSource. Mithilfe der InsertCopies-Methode werden der DataGridViewRowCollection freigegebene Zeilen hinzufügt (falls möglich). Andernfalls werden die neuen Zeilen nicht freigegeben. 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 durch Sortieren an ihre richtige Position zu bringen, rufen Sie die System.Windows.Forms.DataGridView.Sort-Methode in einem DataGridView.RowsAdded-Ereignishandler auf. Sie können auch die System.Windows.Forms.DataGridView.Sort-Methode in einem CellValueChanged-Ereignishandler aufrufen, um die Zeilen zu sortieren, wenn der Benutzer eine Zelle ändert.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen: