Bagikan melalui


SqlDataSourceView.ExecuteInsert(IDictionary) Metode

Definisi

Melakukan operasi penyisipan menggunakan InsertCommand string SQL, parameter apa pun yang ditentukan dalam InsertParameters koleksi, dan nilai yang ada dalam koleksi yang ditentukan values .

protected:
 override int ExecuteInsert(System::Collections::IDictionary ^ values);
protected override int ExecuteInsert (System.Collections.IDictionary values);
override this.ExecuteInsert : System.Collections.IDictionary -> int
Protected Overrides Function ExecuteInsert (values As IDictionary) As Integer

Parameter

values
IDictionary

Nilai IDictionary yang digunakan dengan InsertCommand properti untuk melakukan operasi sisipkan database. Jika tidak ada parameter yang terkait dengan kueri atau jika InsertCommand properti bukan kueri SQL berparameter, lewati null.

Mengembalikan

Nilai yang menunjukkan jumlah baris yang disisipkan ke dalam database yang mendasar.

Pengecualian

SqlDataSource tidak dapat membuat koneksi dengan sumber data yang mendasar.

Pengguna saat ini tidak memiliki izin yang benar untuk mendapatkan akses ke database.

Properti CanInsert adalah false.

Keterangan

Kelas SqlDataSourceView mengimplementasikan metode yang diwariskan ExecuteInsert untuk menyisipkan data ke dalam database. Pengembang halaman dan penulis kontrol terikat data tidak memanggil ExecuteInsert metode secara langsung; sebagai gantinya, gunakan metode yang diekspos Insert secara publik.

Sebelum operasi penyisipan dilakukan, OnInserting metode dipanggil untuk menaikkan Inserting peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai parameter dan melakukan praproscesing apa pun sebelum penyisipan.

Untuk melakukan operasi penyisipan, SqlDataSourceView objek membangun DbCommand objek menggunakan InsertCommand teks dan properti terkait InsertParameters , lalu menjalankan objek terhadap database yang mendasar DbCommand . Setelah penyisipan selesai, OnInserted metode dipanggil untuk menaikkan Inserted peristiwa. Anda dapat menangani peristiwa ini untuk memeriksa nilai pengembalian dan kode kesalahan dan untuk melakukan pasca-pemrosesan.

Berlaku untuk

Lihat juga