DbCommand.ExecuteNonQueryAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Ta metoda implementuje asynchroniczną wersję ExecuteNonQuery()elementu , ale zwraca Task synchronicznie, blokując wątek wywołujący.

Przeciążenia

ExecuteNonQueryAsync(CancellationToken)

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łaszane przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

ExecuteNonQueryAsync()

Asynchroniczna wersja elementu ExecuteNonQuery(), która wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem. ExecuteNonQueryAsync(CancellationToken) Wywołuje element z elementem CancellationToken.None.

Uwagi

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

ExecuteNonQueryAsync(CancellationToken)

Źródło:

DbCommand.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łaszane przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek 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:
 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)

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 polecenia.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

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

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez ExecuteNonQuery()usługę .

Zobacz też

• Omówienie ADO.NET

ExecuteNonQueryAsync()

Źródło:

DbCommand.cs

Asynchroniczna wersja elementu ExecuteNonQuery(), która wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync(CancellationToken) Wywołuje element z elementem 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)

Zwraca

Task<Int32>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

DbException

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

Uwagi

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

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez ExecuteNonQuery()usługę .

Zobacz też

• Omówienie ADO.NET