IDbCommand.ExecuteScalar Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

Sorguyu yürütür ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndürür. Ek sütunlar veya satırlar yoksayılır.

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Döndürülenler

Object

Sonuç kümesindeki ilk satırın ilk sütunu.

Örnekler

Aşağıdaki örnek, SqlCommandtüretilmiş sınıfının bir örneğini oluşturur ve kullanarak ExecuteScalaryürütür. Örnek, bir toplama sonucu döndüren transact-SQL deyimi olan bir dize ve veri kaynağına bağlanmak için kullanılacak bir dize geçirilir.

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

Açıklamalar

Veritabanından ExecuteScalar tek bir değer (örneğin, bir toplama değeri) almak için yöntemini kullanın. Bunun için yöntemini kullanmaktan ExecuteReader daha az kod gerekir ve ardından tarafından döndürülen IDataReaderverileri kullanarak tek değeri oluşturmak için gerekli işlemleri gerçekleştirmeniz gerekir.

Tipik ExecuteScalar bir sorgu aşağıdaki C# örneğinde olduğu gibi biçimlendirilebilir:

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

Sonuç kümesindeki ilk satırın ilk sütunu bulunamazsa, null başvuru (Nothing Visual Basic'te) döndürülür. Veritabanındaki değer ise null, sorgu döndürür DBNull.Value.