DataGridViewRowCollection.Add 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 satu atau beberapa baris ke koleksi.
Overload
Add() |
Menambahkan baris baru ke koleksi. |
Add(Int32) |
Menambahkan jumlah baris baru yang ditentukan ke koleksi. |
Add(Object[]) |
Menambahkan baris baru ke koleksi, dan mengisi sel dengan objek yang ditentukan. |
Add(DataGridViewRow) |
Menambahkan yang ditentukan DataGridViewRow ke koleksi. |
Add()
Menambahkan baris baru ke koleksi.
public:
virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer
Mengembalikan
Indeks baris baru.
Pengecualian
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-
tidak DataGridView memiliki kolom.
-atau-
Operasi ini akan menambahkan baris beku setelah baris yang tidak dibekukan.
Baris yang RowTemplate dikembalikan oleh properti memiliki lebih banyak sel daripada kolom dalam kontrol.
Keterangan
Kelebihan Add() beban menambahkan baris yang didasarkan pada RowTemplate dari DataGridView. Baris baru dibagikan, jika memungkinkan. Pastikan bahwa baris yang ditentukan dalam RowTemplate properti dapat dibagikan untuk skalabilitas terbaik. 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
- Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView
Berlaku untuk
Add(Int32)
Menambahkan jumlah baris baru yang ditentukan ke koleksi.
public:
virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer
Parameter
- count
- Int32
Jumlah baris yang akan ditambahkan ke DataGridViewRowCollection.
Mengembalikan
Indeks baris terakhir yang ditambahkan.
Pengecualian
count
kurang dari 1.
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-
tidak DataGridView memiliki kolom.
-atau-
Baris yang RowTemplate dikembalikan oleh properti memiliki lebih banyak sel daripada kolom dalam kontrol.
-atau-
Operasi ini akan menambahkan baris beku setelah baris yang tidak dibekukan.
Keterangan
Metode menambahkan Add(Int32) baris bersama ke DataGridViewRowCollection. Baris baru didasarkan pada RowTemplate dari DataGridView. Pastikan bahwa baris yang ditentukan dalam RowTemplate properti dapat dibagikan untuk skalabilitas terbaik. 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
Berlaku untuk
Add(Object[])
Menambahkan baris baru ke koleksi, dan mengisi sel dengan objek yang ditentukan.
public:
virtual int Add(... cli::array <System::Object ^> ^ values);
public virtual int Add (params object[] values);
abstract member Add : obj[] -> int
override this.Add : obj[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer
Parameter
- values
- Object[]
Jumlah variabel objek yang mengisi sel-sel baru DataGridViewRow.
Mengembalikan
Indeks baris baru.
Pengecualian
values
adalah null
.
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 VirtualMode dari DataGridView diatur ke true
.
-atau-
Properti DataSource dari DataGridView bukan null
.
-atau-
tidak DataGridView memiliki kolom.
-atau-
Baris yang RowTemplate dikembalikan oleh properti memiliki lebih banyak sel daripada kolom dalam kontrol.
-atau-
Operasi ini akan menambahkan baris beku setelah baris yang tidak dibekukan.
Keterangan
Metode Add(Object[]) menambahkan baris yang tidak dibagikan ke DataGridViewRowCollection. 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
Berlaku untuk
Add(DataGridViewRow)
Menambahkan yang ditentukan DataGridViewRow ke koleksi.
public:
virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int
Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer
Parameter
- dataGridViewRow
- DataGridViewRow
untuk DataGridViewRow ditambahkan ke DataGridViewRowCollection.
Mengembalikan
Indeks dari yang baru DataGridViewRow.
Pengecualian
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-
tidak DataGridView memiliki kolom.
-atau-
Properti DataGridView dari dataGridViewRow
bukan null
.
-atau-
dataGridViewRow
memiliki Selected nilai properti .true
-atau-
Operasi ini akan menambahkan baris beku setelah baris yang tidak dibekukan.
dataGridViewRow
adalah null
.
dataGridViewRow
memiliki lebih banyak sel daripada kolom dalam kontrol.
Keterangan
Metode menambahkan Add(DataGridViewRow) 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
- DataGridViewColumn
- CellTemplate
- Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView