OleDbCommand.ExecuteScalar Yöntem

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-rc.2.24473.5

Kaynak:

OleDbCommand.cs

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:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Döndürülenler

Object

Sonuç kümesindeki ilk satırın ilk sütunu veya sonuç kümesi boşsa null başvuru.

Uygulamalar

ExecuteScalar()

Özel durumlar

InvalidOperationException

Bağlantının ilk olarak listelendiği bağlamdan farklı bir işlem bağlamı içinde komut yürütülemez.

Örnekler

Aşağıdaki örnek bir OleDbCommand oluşturur ve kullanarak ExecuteScalaryürütür. Örnekte, toplama sonucu döndüren bir SQL deyimi olan bir dize ve veri kaynağına bağlanmak için kullanılacak bir dize geçirilir.

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

Açıklamalar

ExecuteScalar Veri kaynağından 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 tek değeri oluşturmak için gereken işlemlerin bir OleDbDataReadertarafından döndürülen verileri kullanarak gerçekleştirilmesi gerekir.

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

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

Ayrıca bkz.

• Komutlarla Çalışma