IDbCommand.ExecuteNonQuery Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Menjalankan pernyataan SQL terhadap Connection objek penyedia data .NET, dan mengembalikan jumlah baris yang terpengaruh.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Mengembalikan

Int32

Jumlah baris yang terpengaruh.

Pengecualian

InvalidOperationException

Koneksi tidak ada.

-atau-

Koneksi tidak terbuka.

Contoh

Contoh berikut membuat instans kelas turunan, OleDbCommand, lalu menjalankannya. Untuk mencapai hal ini, metode ini diteruskan string yang merupakan pernyataan SQL SELECT 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, 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 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 semua jenis pernyataan lainnya, nilai yang dikembalikan adalah -1.