OdbcCommand.ExecuteNonQuery Metode

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.3.24172.9

Sumber:

OdbcCommand.cs

Menjalankan pernyataan SQL terhadap Connection dan mengembalikan jumlah baris yang terpengaruh.

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Mengembalikan

Int32

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.

Pengecualian

InvalidOperationException

Koneksi tidak ada.

-atau-

Koneksi tidak terbuka.

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.

Lihat juga

• Menjalankan Perintah