OracleCommand.ExecuteNonQuery Metode

Definisi

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

Koneksi tidak ada.

-atau-

Koneksi tidak terbuka.

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.

Berlaku untuk

Lihat juga