DbBatch.ExecuteScalarAsync(CancellationToken) 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.
Een asynchrone versie van ExecuteScalar(), waarmee de batch wordt uitgevoerd en de eerste kolom van de eerste rij in de eerste geretourneerde resultatenset wordt geretourneerd. Alle andere kolommen, rijen en resultatensets worden genegeerd.
public abstract System.Threading.Tasks.Task<object?> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken = default);
abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public MustOverride Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)
Parameters
- cancellationToken
- CancellationToken
Een token om de asynchrone bewerking te annuleren.
Retouren
De eerste kolom van de eerste rij in de eerste resultatenset.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de batch.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExecuteScalar()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.