DbCommand.ExecuteScalarAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Implementuje asynchroniczną wersję elementu ExecuteScalar(), ale zwraca Task synchronicznie, blokując wątek wywołujący.
Przeciążenia
| ExecuteScalarAsync() |
Asynchroniczna wersja ExecuteScalar()elementu , która wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane. ExecuteScalarAsync(CancellationToken) Wywołuje element CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Jest to asynchroniczna wersja programu ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany. Domyślna implementacja wywołuje metodę synchroniczną ExecuteScalar() 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 element ExecuteScalar będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania. Nie należy wywoływać innych metod i właściwości |
Uwagi
Aby uzyskać więcej informacji na temat programowania asynchronicznego, zobacz Programowanie asynchroniczne.
ExecuteScalarAsync()
- Źródło:
- DbCommand.cs
- Źródło:
- DbCommand.cs
- Źródło:
- DbCommand.cs
Asynchroniczna wersja ExecuteScalar()elementu , która wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.
ExecuteScalarAsync(CancellationToken) Wywołuje element 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)Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
Wystąpił błąd podczas wykonywania polecenia.
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 ExecuteScalar()usługę .
Zobacz też
Dotyczy
ExecuteScalarAsync(CancellationToken)
- Źródło:
- DbCommand.cs
- Źródło:
- DbCommand.cs
- Źródło:
- DbCommand.cs
Jest to asynchroniczna wersja programu ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.
Domyślna implementacja wywołuje metodę synchroniczną ExecuteScalar() 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 element ExecuteScalar będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku 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<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)Parametry
- cancellationToken
- CancellationToken
Token umożliwiający anulowanie operacji asynchronicznej.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wyjątki
Wystąpił błąd podczas wykonywania polecenia.
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 ExecuteScalar()usługę .
