DbCommand.ExecuteScalarAsync Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Implementuje asynchronní verzi nástroje ExecuteScalar(), ale vrátí Task synchronně blokující volající vlákno.

Přetížení

ExecuteScalarAsync()

Asynchronní verze nástroje ExecuteScalar(), která spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují. Vyvolá pomocí ExecuteScalarAsync(CancellationToken) CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Toto je asynchronní verze nástroje ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteScalar budou sděleny prostřednictvím vrácené vlastnosti Task Exception. Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha.

Poznámky

Další informace o asynchronním programování najdete v tématu Asynchronní programování.

ExecuteScalarAsync()

Zdroj:

DbCommand.cs

Asynchronní verze nástroje ExecuteScalar(), která spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují.

Vyvolá pomocí ExecuteScalarAsync(CancellationToken) CancellationToken.None.

public:
 System::Threading::Tasks::Task<System::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)

Návraty

Task<Object>

Úloha představující asynchronní operaci

Výjimky

DbException

Při provádění příkazu došlo k chybě.

Poznámky

Další informace o asynchronním programování najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteScalar().

Viz také

• Přehled ADO.NET

ExecuteScalarAsync(CancellationToken)

Zdroj:

DbCommand.cs

Toto je asynchronní verze nástroje ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován.

Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteScalar budou sděleny prostřednictvím vrácené vlastnosti Task Exception.

Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha.

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);

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 pro zrušení asynchronní operace.

Návraty

Task<Object>

Úloha představující asynchronní operaci

Výjimky

DbException

Při provádění příkazu došlo k chybě.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Další informace o asynchronním programování najdete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteScalar().

Viz také

• Přehled ADO.NET