OracleCommand.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:
virtual int ExecuteNonQuery();
public:
override int ExecuteNonQuery();
public int ExecuteNonQuery ();
public override int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer
Mengembalikan
Untuk pernyataan UPDATE, INSERT, dan DELETE, nilai yang dikembalikan adalah jumlah baris yang terpengaruh oleh perintah. Untuk pernyataan CREATE TABLE dan DROP TABLE, nilai yang dikembalikan adalah 0. Untuk semua jenis pernyataan lainnya, nilai yang dikembalikan adalah -1.
Penerapan
Pengecualian
Contoh
Contoh berikut membuat OracleCommand lalu menjalankannya dengan menggunakan ExecuteNonQuery. Contohnya diteruskan string yang merupakan pernyataan SQL (seperti UPDATE, INSERT, atau DELETE) dan string yang akan digunakan untuk menyambungkan ke database.
public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
using (OracleConnection connection = new OracleConnection(connectionString))
{
OracleCommand command = new OracleCommand(myExecuteQuery, connection);
command.Connection.Open();
command.ExecuteNonQuery();
}
}
Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
Using connection As New OracleConnection(connectionString)
Dim command As New OracleCommand(myExecuteQuery, connection)
command.Connection.Open()
command.ExecuteNonQuery()
End Using
End Sub
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 mengeksekusi 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 baris yang terpengaruh oleh perintah. Untuk pernyataan CREATE TABLE dan DROP TABLE, nilai yang dikembalikan adalah 0. Untuk semua jenis pernyataan lainnya, nilai yang dikembalikan adalah -1. Jika pembatalan terjadi, nilai yang dikembalikan juga -1.