DbCommand.ExecuteNonQueryAsync 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.
Den här metoden implementerar den asynkrona versionen av ExecuteNonQuery(), men returnerar en Task synkront blockering av den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| ExecuteNonQueryAsync(CancellationToken) |
Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras. Standardimplementeringen anropar den synkrona ExecuteNonQuery() 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 ExecuteNonQuery() kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel. Anropa inte andra metoder och egenskaper för |
| ExecuteNonQueryAsync() |
En asynkron version av ExecuteNonQuery(), som kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas. Anropar ExecuteNonQueryAsync(CancellationToken) med CancellationToken.None. |
Kommentarer
Mer information om asynkron programmering finns i Asynkron programmering.
ExecuteNonQueryAsync(CancellationToken)
Det här är den asynkrona versionen av ExecuteNonQuery(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan eventuellt ignoreras.
Standardimplementeringen anropar den synkrona ExecuteNonQuery() 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 ExecuteNonQuery() kommer att 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<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)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 ExecuteNonQuery().
Se även
Gäller för
ExecuteNonQueryAsync()
En asynkron version av ExecuteNonQuery(), som kör kommandot mot dess anslutningsobjekt och returnerar antalet rader som påverkas.
Anropar ExecuteNonQueryAsync(CancellationToken) med CancellationToken.None.
public:
System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync();member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>Public Function ExecuteNonQueryAsync () As Task(Of Integer)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 ExecuteNonQuery().