DbCommand.ExecuteScalar Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují.
public:
abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar();
public abstract object? ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object
Návraty
První sloupec prvního řádku v první sadě výsledků
Implementuje
Poznámky
Použijte metodu ExecuteScalar k načtení jedné hodnoty (například agregační hodnoty) z databáze. To vyžaduje méně kódu než použití ExecuteReader metody a provádění operací nezbytných k vygenerování jedné hodnoty pomocí dat vrácených DbDataReaderfunkcí .
Pokud se nenajde první sloupec prvního řádku v sadě výsledků, vrátí se nulový odkaz (Nothing v Visual Basic). Pokud je nullhodnota v databázi , dotaz vrátí DBNull.Value.