SqlDataReader.ReadAsync(CancellationToken) Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Asynchronní verze nástroje Read(), která přejde na SqlDataReader další záznam.

Token zrušení lze použít k vyžádání, aby byla operace zrušena 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> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (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í ReadAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úlohy.

SqlException

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

Poznámky

behavior Pokud je parametr ExecuteReaderAsync nastaven na Defaulthodnotu , ReadAsync přečte před vrácením úkolu celý řádek.

Další informace, včetně ukázek kódu, o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.

Poznámka

Při čtení velkých dat (binárních nebo textových) se doporučuje použít Read pro optimální výkon.