OleDbCommand.ExecuteScalar 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 kueri, dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil yang dikembalikan oleh kueri. Kolom atau baris tambahan diabaikan.

public:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Mengembalikan

Object

Kolom pertama dari baris pertama dalam tataan hasil, atau referensi null jika tataan hasil kosong.

Penerapan

ExecuteScalar()

Pengecualian

InvalidOperationException

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

Contoh

Contoh berikut membuat OleDbCommand lalu menjalankannya menggunakan ExecuteScalar. Contohnya diteruskan string yang merupakan pernyataan SQL yang mengembalikan hasil agregat, dan string yang digunakan untuk menyambungkan ke sumber data.

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Keterangan

ExecuteScalar Gunakan metode untuk mengambil satu nilai, misalnya, nilai agregat, dari sumber data. Ini membutuhkan lebih sedikit kode daripada menggunakan ExecuteReader metode , lalu melakukan operasi yang diperlukan untuk menghasilkan nilai tunggal menggunakan data yang OleDbDataReaderdikembalikan oleh .

Kueri umum ExecuteScalar dapat diformat seperti dalam contoh C# berikut:

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (int32) ExecuteScalar();  

Lihat juga

• Bekerja dengan Perintah