OleDbCommand.ExecuteScalar Yöntem

Tanım

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:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar ();
public object ExecuteScalar ();
public override object ExecuteScalar ();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

Döndürülenler

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

Uygulamalar

Özel durumlar

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();  

Şunlara uygulanır

Ayrıca bkz.