IDbCommand.ExecuteScalar Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Menjalankan kueri, dan mengembalikan kolom pertama dari baris pertama dalam hasil yang dikembalikan oleh kueri. Kolom atau baris tambahan diabaikan.

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Mengembalikan

Object

Kolom pertama dari baris pertama dalam resultset.

Contoh

Contoh berikut membuat instans kelas turunan, SqlCommand, lalu menjalankannya menggunakan ExecuteScalar. Contohnya diteruskan string yang merupakan pernyataan Transact-SQL yang mengembalikan hasil agregat, dan string yang digunakan untuk menyambungkan ke sumber data.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Keterangan

ExecuteScalar Gunakan metode untuk mengambil satu nilai (misalnya, nilai agregat) dari database. Ini membutuhkan lebih sedikit kode daripada menggunakan ExecuteReader metode , dan kemudian melakukan operasi yang diperlukan untuk menghasilkan nilai tunggal menggunakan data yang IDataReaderdikembalikan oleh .

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

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

Jika kolom pertama dari baris pertama dalam tataan hasil tidak ditemukan, referensi null (Nothing di Visual Basic) dikembalikan. Jika nilai dalam database adalah null, kueri mengembalikan DBNull.Value.