DbCommand.ExecuteScalar Yöntem

Tanım

komutunu yürütür ve döndürülen ilk sonuç kümesindeki ilk satırın ilk sütununu döndürür. Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır.

C#
public abstract object ExecuteScalar ();
C#
public abstract object? ExecuteScalar ();

Döndürülenler

İlk sonuç kümesindeki ilk satırın ilk sütunu.

Uygulamalar

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 ve tarafından DbDataReaderdöndürülen verileri kullanarak tek değeri oluşturmak için gereken işlemleri gerçekleştirmekten daha az kod gerekir.

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.

Şunlara uygulanır

Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Ayrıca bkz.