Share via

DbBatch.ExecuteNonQueryAsync(CancellationToken) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.Common
Zestaw:
System.Data.Common.dll
Źródło:
DbBatch.cs
Źródło:
DbBatch.cs
Źródło:
DbBatch.cs

Jest to asynchroniczna wersja programu ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłoszone przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania.

Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

public abstract System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public MustOverride Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

Parametry

cancellationToken
CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej.

Zwraca

Task<Int32>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

DbException

Wystąpił błąd podczas wykonywania partii.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego, zobacz Programowanie asynchroniczne.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez ExecuteNonQuery()usługę .

Dotyczy

Zobacz też