DbCommand.ExecuteScalarAsync 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.
Implementeert de asynchrone versie van ExecuteScalar(), maar retourneert een Task synchrone, waardoor de aanroepende thread wordt geblokkeerd.
Overloads
| Name | Description |
|---|---|
| ExecuteScalarAsync() |
Een asynchrone versie van ExecuteScalar(), waarmee de opdracht 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. Roept aan ExecuteScalarAsync(CancellationToken) met CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Dit is de asynchrone versie van ExecuteScalar(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd. De standaardimplementatie roept de synchrone ExecuteScalar() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd door ExecuteScalar, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Roep geen andere methoden en eigenschappen van het |
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering.
ExecuteScalarAsync()
Een asynchrone versie van ExecuteScalar(), waarmee de opdracht 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.
Roept aan ExecuteScalarAsync(CancellationToken) met CancellationToken.None.
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<object> ExecuteScalarAsync();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de opdracht.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering.
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.
Zie ook
Van toepassing op
ExecuteScalarAsync(CancellationToken)
Dit is de asynchrone versie van ExecuteScalar(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden genegeerd.
De standaardimplementatie roept de synchrone ExecuteScalar() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die worden gegenereerd door ExecuteScalar, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.
Roep geen andere methoden en eigenschappen van het DbCommand object aan totdat de geretourneerde taak is voltooid.
public:
virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)Parameters
- cancellationToken
- CancellationToken
Een token om de asynchrone bewerking te annuleren.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de opdracht.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering.
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.