Bagikan melalui


DataGridViewRowCollection.AddCopy(Int32) Metode

Definisi

Menambahkan baris baru berdasarkan baris pada indeks yang ditentukan.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

Parameter

indexSource
Int32

Indeks baris untuk mendasarkan baris baru.

Mengembalikan

Indeks baris baru.

Pengecualian

indexSource kurang dari nol atau lebih besar dari atau sama dengan jumlah baris dalam koleksi.

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 :

-atau-

Properti DataSource dari DataGridView bukan null.

-atau-

Operasi ini akan menambahkan baris beku setelah baris yang tidak dibekukan.

Keterangan

Properti InheritedStyle baris baru memiliki nilai yang sama dengan InheritedStyle baris yang diposisikan di indexSource. Metode AddCopy menambahkan 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.

Berlaku untuk

Lihat juga