DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metódus

Definíció

A szolgáltatóknak ezt a módszert úgy kell implementálniuk, hogy a túlterhelések nem alapértelmezett implementációt biztosítsanak ExecuteReader .

Az alapértelmezett implementáció meghívja a szinkron ExecuteReader() metódust, és egy befejezett feladatot ad vissza, blokkolva a hívó szálat. Az alapértelmezett implementáció visszavont feladatot ad vissza, ha már lemondott lemondási jogkivonatot adott át. Az ExecuteReader által kiadott kivételek a visszaadott Tevékenységkivétel tulajdonságon keresztül lesznek közölve.

Ez a metódus elfogad egy lemondási jogkivonatot, amely a művelet korai törlésének igénylésére használható. A megvalósítások figyelmen kívül hagyhatják ezt a kérést.

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)

Paraméterek

behavior
CommandBehavior

Egy példány, amely megadja a CommandBehaviorparancs végrehajtásának és az adatlekérésnek a beállításait.

cancellationToken
CancellationToken

Jogkivonat az aszinkron művelet megszakításához.

Válaszok

Az aszinkron műveletet képviselő feladat.

Kivételek

Hiba történt a parancs végrehajtása közben.

Érvénytelen CommandBehavior érték.

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Az aszinkron programozásról további információt az Aszinkron programozás című témakörben talál.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ExecuteDbDataReader(CommandBehavior)kiadott kivételeket: .

A következőre érvényes:

Lásd még