OleDbCommand.ExecuteNonQuery Metode

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

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

Sumber:

OleDbCommand.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

Jumlah baris yang terpengaruh.

Penerapan

ExecuteNonQuery()

Pengecualian

InvalidOperationException

Koneksi tidak ada.

-atau-

Koneksi tidak terbuka.

-atau-

Tidak dapat menjalankan perintah dalam konteks transaksi yang berbeda dari konteks di mana koneksi awalnya terdaftar.

Contoh

Contoh berikut membuat OleDbCommand lalu menjalankannya menggunakan ExecuteNonQuery. Contohnya diteruskan string yang merupakan pernyataan SQL seperti UPDATE, INSERT, atau DELETE, dan string yang digunakan untuk menyambungkan ke sumber data.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

Keterangan

Anda bisa menggunakan ExecuteNonQuery untuk melakukan operasi katalog, misalnya, untuk 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.

ExecuteNonQuery Meskipun 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.

Lihat juga

• Bekerja dengan Perintah