SqlBatch.ExecuteNonQuery Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Menjalankan batch terhadap objek koneksinya, mengembalikan jumlah total baris yang terpengaruh di semua perintah batch.

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Mengembalikan

Int32

Jumlah total baris yang terpengaruh di semua perintah batch.

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 dengan menjalankan pernyataan UPDATE, INSERT, atau DELETE.

Meskipun ExecuteNonQuery tidak mengembalikan baris apa pun, 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 total baris yang terpengaruh oleh batch. Jika tidak ada pernyataan UPDATE, INSERT, atau DELETE yang disertakan dalam batch, nilai yang dikembalikan adalah -1.

Catatan

Metode ini mendapat manfaat dari ExecuteNonQuery(), dan semua pengecualian yang diharapkan dari metode itu juga berlaku di sini.