DataGridViewRowCollection.Insert 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.
Sisipkan satu atau beberapa baris ke dalam koleksi.
Overload
Insert(Int32, DataGridViewRow) |
Sisipkan yang ditentukan DataGridViewRow ke dalam koleksi. |
Insert(Int32, Int32) |
Menyisipkan jumlah baris yang ditentukan ke dalam koleksi pada lokasi yang ditentukan. |
Insert(Int32, Object[]) |
Menyisipkan baris ke dalam koleksi pada posisi yang ditentukan, dan mengisi sel dengan objek yang ditentukan. |
Insert(Int32, DataGridViewRow)
Sisipkan yang ditentukan DataGridViewRow ke dalam koleksi.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit
Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)
Parameter
- rowIndex
- Int32
Posisi untuk menyisipkan baris.
- dataGridViewRow
- DataGridViewRow
DataGridViewRow untuk menyisipkan ke DataGridViewRowCollectiondalam .
Pengecualian
rowIndex
kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.
dataGridViewRow
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 DataSource dari DataGridView bukan null
.
-atau-
rowIndex
sama dengan jumlah baris dalam koleksi dan AllowUserToAddRows properti diatur DataGridView ke true
.
-atau-
tidak DataGridView memiliki kolom.
-atau-
Properti DataGridView dari dataGridViewRow
bukan null
.
-atau-
dataGridViewRow
memiliki Selected nilai properti .true
-atau-
Operasi ini akan menyisipkan baris beku setelah baris yang tidak dibekukan atau baris yang tidak dibekukan sebelum baris yang dibekukan.
dataGridViewRow
memiliki lebih banyak sel daripada kolom dalam kontrol.
Keterangan
Metode menambahkan Insert(Int32, 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
Berlaku untuk
Insert(Int32, Int32)
Menyisipkan jumlah baris yang ditentukan ke dalam koleksi pada lokasi yang ditentukan.
public:
virtual void Insert(int rowIndex, int count);
public virtual void Insert (int rowIndex, int count);
abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit
Public Overridable Sub Insert (rowIndex As Integer, count As Integer)
Parameter
- rowIndex
- Int32
Posisi untuk menyisipkan baris.
- count
- Int32
Jumlah baris yang akan disisipkan ke DataGridViewRowCollectiondalam .
Pengecualian
rowIndex
kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.
-atau-
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-
rowIndex
sama dengan jumlah baris dalam koleksi dan AllowUserToAddRows properti diatur DataGridView ke true
.
-atau-
Baris yang RowTemplate dikembalikan oleh properti memiliki lebih banyak sel daripada kolom dalam kontrol.
-atau-
Operasi ini akan menyisipkan baris beku setelah baris yang tidak dibekukan atau baris yang tidak dibekukan sebelum baris yang dibekukan.
Keterangan
Metode menambahkan Insert(Int32, Int32) 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
Berlaku untuk
Insert(Int32, Object[])
Menyisipkan baris ke dalam koleksi pada posisi yang ditentukan, dan mengisi sel dengan objek yang ditentukan.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);
public virtual void Insert (int rowIndex, params object[] values);
abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit
Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())
Parameter
- rowIndex
- Int32
Posisi untuk menyisipkan baris.
- values
- Object[]
Jumlah variabel objek yang mengisi sel baris baru.
Pengecualian
rowIndex
kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.
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-
rowIndex
sama dengan jumlah baris dalam koleksi dan AllowUserToAddRows properti diatur DataGridView ke true
.
-atau-
Properti DataGridView baris yang dikembalikan oleh properti kontrol RowTemplate bukan null
.
-atau-
Operasi ini akan menyisipkan baris beku setelah baris yang tidak dibekukan atau baris yang tidak dibekukan sebelum baris yang dibekukan.
Baris yang dikembalikan oleh properti kontrol RowTemplate memiliki lebih banyak sel daripada kolom dalam kontrol.
Keterangan
Metode Insert(Int32, Object[]) menambahkan baris yang tidak dibagikan ke DataGridViewRowCollection.
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.