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í potřebných k vygenerování jedné hodnoty pomocí dat vrácených DbDataReadernástrojem .
Pokud první sloupec prvního řádku v sadě výsledků není nalezen, vrátí se odkaz null (Nothing
v jazyce Visual Basic). Pokud je null
hodnota v databázi , vrátí DBNull.Value
dotaz .