DbCommand.ExecuteScalar Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voert de opdracht uit en retourneert de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset. Alle andere kolommen, rijen en resultatensets worden genegeerd.
public:
abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object
Retouren
De eerste kolom van de eerste rij in de eerste resultatenset.
Implementeringen
Opmerkingen
Gebruik de ExecuteScalar methode om één waarde (bijvoorbeeld een statistische waarde) op te halen uit een database. Hiervoor is minder code vereist dan het gebruik van de ExecuteReader methode en het uitvoeren van de bewerkingen die nodig zijn om de enkele waarde te genereren met behulp van de gegevens die door een DbDataReader.
Als de eerste kolom van de eerste rij in de resultatenset niet wordt gevonden, wordt een null-verwijzing (Nothing in Visual Basic) geretourneerd. Als de waarde in de database is null, retourneert DBNull.Valuede query.