DbCommand.ExecuteScalar Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.
public:
abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar ();
public abstract object? ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object
Zwraca
Pierwsza kolumna pierwszego wiersza w pierwszym zestawie wyników.
Implementuje
Uwagi
ExecuteScalar Użyj metody , aby pobrać pojedynczą wartość (na przykład zagregowaną wartość) z bazy danych. Wymaga to mniejszej ExecuteReader ilości kodu niż użycie metody i wykonanie operacji niezbędnych do wygenerowania pojedynczej wartości przy użyciu danych zwracanych przez metodę DbDataReader.
Jeśli pierwsza kolumna pierwszego wiersza w zestawie wyników nie zostanie znaleziona, zostanie zwrócone odwołanie o wartości null (Nothing
w Języku Visual Basic). Jeśli wartość w bazie danych to null
, zapytanie zwraca wartość DBNull.Value
.