Bagikan melalui

DataGridViewRowCollection.Insert Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

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

ArgumentOutOfRangeException

rowIndex kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.

ArgumentNullException

dataGridViewRowadalah null.

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 :

-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-

dataGridViewRowmemiliki 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.

ArgumentException

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

ArgumentOutOfRangeException

rowIndex kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.

-atau-

count kurang dari 1.

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 :

-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

ArgumentOutOfRangeException

rowIndex kurang dari nol atau lebih besar dari jumlah baris dalam koleksi.

ArgumentNullException

valuesadalah null.

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 :

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

ArgumentException

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.

Lihat juga

Berlaku untuk