OdbcCommand.ExecuteNonQuery 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.
Menjalankan pernyataan SQL terhadap Connection dan mengembalikan jumlah baris yang terpengaruh.
public:
override int ExecuteNonQuery();
public:
virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public Function ExecuteNonQuery () As Integer
Mengembalikan
Untuk pernyataan UPDATE, INSERT, dan DELETE, nilai yang dikembalikan adalah jumlah baris yang terpengaruh oleh perintah. Untuk semua jenis pernyataan lainnya, nilai yang dikembalikan adalah -1.
Penerapan
Pengecualian
Keterangan
Anda bisa menggunakan ExecuteNonQuery untuk melakukan operasi katalog (misalnya, mengkueri struktur database atau membuat objek database seperti tabel); atau untuk mengubah data dalam database, tanpa menggunakan DataSet, dengan menjalankan pernyataan UPDATE, INSERT, atau DELETE.
Anda juga dapat menggunakan ExecuteNonQuery untuk menjalankan beberapa pernyataan SQL jika driver ODBC yang mendasar mendukung fungsionalitas ini. Dalam hal ini, nilai yang dikembalikan adalah jumlah baris yang dipengaruhi oleh semua pernyataan dalam perintah.
Meskipun ExecuteNonQuery tidak mengembalikan baris, parameter output atau nilai pengembalian apa pun yang dipetakan ke parameter diisi dengan data.
Untuk pernyataan UPDATE, INSERT, dan DELETE, nilai yang dikembalikan adalah jumlah baris yang terpengaruh oleh perintah. Untuk semua jenis pernyataan lainnya, nilai yang dikembalikan adalah -1. Jika pembatalan terjadi, nilai yang dikembalikan juga -1.
Saat pemicu ada pada tabel dan data sedang ditambahkan atau diubah dalam tabel, nilai pengembalian menyertakan jumlah baris yang terpengaruh oleh operasi sisipkan atau perbarui dan jumlah baris yang terpengaruh oleh pemicu atau pemicu.