DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
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: .