DataGridViewRowCollection.Insert Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menyisipkan satu atau beberapa baris ke dalam koleksi.

Overload

Nama	Deskripsi
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)

Sumber:

DataGridViewRowCollection.cs

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

untuk DataGridViewRow disisipkan ke DataGridViewRowCollectiondalam .

Pengecualian

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow adalah 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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-atau-

Properti DataSource bukan DataGridViewnull.

-atau-

rowIndex sama dengan jumlah baris dalam koleksi dan AllowUserToAddRows properti diatur DataGridView ke true.

-atau-

tidak DataGridView memiliki kolom.

-atau-

Properti DataGridView bukan dataGridViewRownull.

-atau-

dataGridViewRowmemiliki Selected nilai properti .true

-atau-

Operasi ini akan menyisipkan baris beku setelah baris tidak beku atau baris yang tidak dibekukan sebelum baris beku.

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

Insert(Int32, Int32)

Sumber:

DataGridViewRowCollection.cs

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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-atau-

Properti DataSource bukan DataGridViewnull.

-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 tidak beku atau baris yang tidak dibekukan sebelum baris beku.

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

Insert(Int32, Object[])

Sumber:

DataGridViewRowCollection.cs

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

values adalah 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 :

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-atau-

Properti VirtualMode dari DataGridView diatur ke true.

-atau-

Properti DataSource bukan DataGridViewnull.

-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 tidak beku atau baris yang tidak dibekukan sebelum baris beku.

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

• DataGridView
• DataGridViewRow