DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyisipkan baris ke dalam koleksi pada posisi yang ditentukan.

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);

public virtual void InsertCopies (int indexSource, int indexDestination, int count);

abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit

Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Parameter

indexSource

Int32

Indeks untuk mendasarkan DataGridViewRow baris baru.

indexDestination

Int32

Posisi untuk menyisipkan baris.

count

Int32

Jumlah DataGridViewRow objek yang akan ditambahkan ke DataGridViewRowCollection.

Pengecualian

ArgumentOutOfRangeException

indexSource kurang dari nol atau lebih besar dari jumlah baris dalam koleksi dikurangi satu.

-atau-

indexDestination kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.

-atau-

count kurang dari 1.

InvalidOperationException

Kontrol terkait DataGridView melakukan salah satu tindakan berikut yang untuk sementara mencegah baris baru ditambahkan:

• Memilih semua sel dalam kontrol.

• Menghapus pilihan.

-atau-

Metode ini dipanggil dari handler untuk salah satu peristiwa berikut DataGridView :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-atau-

indexDestination sama dengan jumlah baris dalam koleksi dan AllowUserToAddRows adalah true.

-atau-

Operasi ini akan menyisipkan baris beku setelah baris yang tidak dibekukan atau baris yang tidak dibekukan sebelum baris beku.

Keterangan

Properti InheritedStyle objek baru DataGridViewRow memiliki nilai yang sama dengan InheritedStyle dari yang DataGridViewRow diposisikan di indexSource. Metode menambahkan InsertCopies baris bersama ke DataGridViewRowCollection, jika memungkinkan. Jika tidak, baris baru tidak dibagikan. Untuk informasi selengkapnya, lihat Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView.

Baris dalam kontrol tidak diurutkan secara otomatis saat baris baru ditambahkan. Untuk mengurutkan baris baru ke posisi yang benar, panggil DataGridView.Sort metode dalam penanganan DataGridView.RowsAdded aktivitas. Anda mungkin juga ingin memanggil DataGridView.Sort metode dalam CellValueChanged penanganan aktivitas untuk mengurutkan baris saat pengguna memodifikasi sel.

Lihat juga

• DataGridView
• DataGridViewRow