DbDataReader.ReadAsync Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót.

Túlterhelések

Name	Description
ReadAsync()	Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót.
ReadAsync(CancellationToken)	Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót.

Megjegyzések

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

ReadAsync()

Forrás:

DbDataReader.cs

Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót.

public:
 System::Threading::Tasks::Task<bool> ^ ReadAsync();

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

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

Válaszok

Task<Boolean>

Az Task<TResult> a tulajdonság, amelynek Result a tulajdonsága true , ha több sor van, vagy false ha nincs.

Kivételek

DbException

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

Megjegyzések

Az aszinkron metódus alapértelmezett implementációja meghívja a szinkron megfelelőjét, és visszaad egy befejezett feladatot, amely blokkolhatja a hívó szálat.

Az aszinkron programozást támogató adatszolgáltatóknak felül kell bírálnia az alapértelmezett implementációt aszinkron I/O-műveletek használatával.

A DbDataReader objektum egyéb metódusait és tulajdonságait nem lehet meghívni, amíg a visszaadott feladat még nem fejeződött be.

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 Read()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése

ReadAsync(CancellationToken)

Forrás:

DbDataReader.cs

Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót.

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

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

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

Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Paraméterek

cancellationToken

CancellationToken

A lemondási utasítás.

Válaszok

Task<Boolean>

Az Task<TResult> a tulajdonság, amelynek Result a tulajdonsága true , ha több sor van, vagy false ha nincs.

Kivételek

DbException

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

OperationCanceledException

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

Megjegyzések

Az aszinkron metódus alapértelmezett implementációja meghívja a szinkron megfelelőjét, és visszaad egy befejezett feladatot, amely blokkolhatja a hívó szálat. Az alapértelmezett implementáció egy megszakított feladatot is visszaad, ha már lemondott lemondási jogkivonatot adott át.

Az aszinkron programozást támogató adatszolgáltatóknak felül kell bírálnia az alapértelmezett implementációt aszinkron I/O-műveletek használatával.

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.

A DbDataReader objektum egyéb metódusait és tulajdonságait nem lehet meghívni, amíg a visszaadott feladat még nem fejeződött be.

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 Read()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése