SqlDataReader.NextResultAsync(CancellationToken) Metoda

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Asynchronní verze nástroje NextResult(), která při čtení výsledků dávkových příkazů Jazyka Transact-SQL posune čtečku dat k dalšímu výsledku.

Token zrušení lze použít k žádosti o opuštění operace před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

public:
 override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

cancellationToken
CancellationToken

Instrukce zrušení

Návraty

Task<Boolean>

Úloha představující asynchronní operaci

Výjimky

InvalidOperationException

Volání NextResultAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úkolu

Context Connection=true je zadaný v připojovacím řetězci.

SqlException

SQL Server vrátil chybu při provádění textu příkazu.

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í v zprostředkovateli dat rozhraní .NET Framework pro SQL Server 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 NextResult().

Platí pro

Viz také