DataGridViewRowCollection.AddCopy(Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.