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 -> objPublic MustOverride Function ExecuteScalar () As ObjectZwraca
Pierwsza kolumna pierwszego wiersza w pierwszym zestawie wyników.
Implementuje
Uwagi
ExecuteScalar Użyj metody , aby pobrać pojedynczą wartość (na przykład wartość agregowaną) z bazy danych. Wymaga to mniejszego ExecuteReader kodu niż użycie metody i wykonanie operacji niezbędnych do wygenerowania pojedynczej wartości przy użyciu danych zwracanych przez DbDataReaderelement .
Jeśli pierwsza kolumna pierwszego wiersza w zestawie wyników nie zostanie znaleziona, zostanie zwrócone odwołanie o wartości null (Nothingw Visual Basic). Jeśli wartość w bazie danych to null, zapytanie zwraca wartość DBNull.Value.