DbCommand.ExecuteScalarAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Implementerar den asynkrona versionen av ExecuteScalar(), men returnerar en Task synkront blockering av den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| ExecuteScalarAsync() |
En asynkron version av ExecuteScalar(), som kör kommandot och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras. Anropar ExecuteScalarAsync(CancellationToken) med CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Det här är den asynkrona versionen av ExecuteScalar(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras. Standardimplementeringen anropar den synkrona ExecuteScalar() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteScalar kommuniceras via den returnerade egenskapen Aktivitetsfel. Anropa inte andra metoder och egenskaper för |
Kommentarer
Mer information om asynkron programmering finns i Asynkron programmering.
ExecuteScalarAsync()
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
En asynkron version av ExecuteScalar(), som kör kommandot och returnerar den första kolumnen på den första raden i den första returnerade resultatuppsättningen. Alla andra kolumner, rader och resultatuppsättningar ignoreras.
Anropar ExecuteScalarAsync(CancellationToken) med CancellationToken.None.
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<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)Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
Ett fel uppstod när kommandot kördes.
Kommentarer
Mer information om asynkron programmering finns i Asynkron programmering.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ExecuteScalar().
Se även
Gäller för
ExecuteScalarAsync(CancellationToken)
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
- Källa:
- DbCommand.cs
Det här är den asynkrona versionen av ExecuteScalar(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.
Standardimplementeringen anropar den synkrona ExecuteScalar() metoden och returnerar en slutförd uppgift som blockerar den anropande tråden. Standardimplementeringen returnerar en avbruten aktivitet om den skickas en redan avbruten annulleringstoken. Undantag som genereras av ExecuteScalar kommuniceras via den returnerade egenskapen Aktivitetsfel.
Anropa inte andra metoder och egenskaper för DbCommand objektet förrän den returnerade aktiviteten har slutförts.
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);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)Parametrar
- cancellationToken
- CancellationToken
En token för att avbryta den asynkrona åtgärden.
Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
Ett fel uppstod när kommandot kördes.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Mer information om asynkron programmering finns i Asynkron programmering.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av ExecuteScalar().
