IDbCommand.ExecuteScalar Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.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, toplama sonucu döndüren bir 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, 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 IDataReaderdöndürülen verileri kullanarak tek bir değer oluşturmak için gereken 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 (Visual Basic Nothing) döndürülür. Veritabanındaki değer ise null, sorgu döndürür DBNull.Value.