Sdílet prostřednictvím


DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metoda

Definice

Zprostředkovatelé by měli implementovat tuto metodu, aby poskytovala pro přetížení jinou než výchozí implementaci ExecuteReader .

Výchozí implementace vyvolá synchronní ExecuteReader() 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 ExecuteReader budou sděleny prostřednictvím vlastnosti vrácené výjimky úlohy.

Tato metoda přijímá token zrušení, který lze použít k žádosti o předčasné zrušení operace. Implementace můžou tento požadavek ignorovat.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Parametry

behavior
CommandBehavior

Instance nástroje CommandBehavior, která určuje možnosti pro spuštění příkazu a načítání dat.

cancellationToken
CancellationToken

Token pro zrušení asynchronní operace.

Návraty

Úloha představující asynchronní operaci

Výjimky

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

Neplatná CommandBehavior hodnota.

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 ExecuteDbDataReader(CommandBehavior).

Platí pro

Viz také