DataGridViewRowCollection.InsertCopy(Int32, Int32) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyisipkan baris ke dalam koleksi pada posisi yang ditentukan, berdasarkan baris pada posisi yang ditentukan.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);

public virtual void InsertCopy (int indexSource, int indexDestination);

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

Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

Parameter

indexSource

Int32

Indeks baris untuk mendasarkan baris baru.

indexDestination

Int32

Posisi untuk menyisipkan baris.

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.

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 yang dibekukan.

Keterangan

Metode ini menetapkan baris baru indeks yang ditentukan dalam indexDestination parameter dan menaikkan indeks untuk semua baris berikutnya. Properti InheritedStyle baru DataGridViewRow memiliki nilai yang sama dengan InheritedStyle yang DataGridViewRow diposisikan di indexSource. Metode menambahkan InsertCopy 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