DbCommand.ExecuteScalarAsync Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

Implementuje asynchronní verzi ExecuteScalar(), ale vrací Task synchronně, blokuje volající vlákno.

Přetížení

Name	Description
ExecuteScalarAsync()	Asynchronní verze 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í. ExecuteScalarAsync(CancellationToken) Vyvolá se pomocí CancellationToken.None.
ExecuteScalarAsync(CancellationToken)	Toto je asynchronní verze 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteScalar budou oznámeny prostřednictvím vrácené task Exception vlastnost. Nevyvolejte jiné metody a vlastnosti objektu DbCommand , dokud nebude vrácena úloha dokončena.

Poznámky

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

ExecuteScalarAsync()

Zdroj:

DbCommand.cs

Asynchronní verze 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í.

ExecuteScalarAsync(CancellationToken) Vyvolá se pomocí 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í naleznete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteScalar().

Viz také

• Přehled ADO.NET

ExecuteScalarAsync(CancellationToken)

Zdroj:

DbCommand.cs

Toto je asynchronní verze 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteScalar budou oznámeny prostřednictvím vrácené task Exception vlastnost.

Nevyvolejte jiné metody a vlastnosti objektu DbCommand , dokud nebude vrácena úloha dokončena.

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 do vrácené úlohy.

Poznámky

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

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané ExecuteScalar().

Viz také

• Přehled ADO.NET