DbDataReader.GetFieldValueAsync Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.

Túlterhelések

Name	Description
GetFieldValueAsync<T>(Int32)	Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.
GetFieldValueAsync<T>(Int32, CancellationToken)	Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.

GetFieldValueAsync<T>(Int32)

Forrás:

DbDataReader.cs

Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.

public:
generic <typename T>
 System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal);

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int ordinal);

member this.GetFieldValueAsync : int -> System.Threading.Tasks.Task<'T>

Public Function GetFieldValueAsync(Of T) (ordinal As Integer) As Task(Of T)

Típusparaméterek

T

A visszaadandó érték típusa.

Paraméterek

ordinal

Int32

A nulla alapú oszloprend.

Válaszok

Task<T>

Olyan tevékenység, amely Result a megadott oszlop értékét tartalmazza.

Kivételek

InvalidOperationException

A kapcsolat megszakadt vagy megszakadt az adatlekérés során.

-vagy-

Az adatolvasó az adatlekérés során bezárult.

-vagy-

Nincs olvasásra kész adat (például az első Read() nem lett meghívva, vagy vissza lett adva false).

-vagy-

Megpróbált beolvasni egy korábban beolvasott oszlopot szekvenciális módban.

-vagy-

Aszinkron művelet volt folyamatban. Ez az összes Get_*_ metódusra vonatkozik, ha szekvenciális módban futnak, mivel a stream olvasása közben meghívhatók.

IndexOutOfRangeException

Az oszlopindex tartományon kívül esik.

InvalidCastException

Az adatbázis által visszaadott érték nem egyezik meg vagy nem vethető be.T

Megjegyzések

Ez az aszinkron módszer csak azért szükséges, hogy elkerülje a hívó szál blokkolását, amikor az olvasó szekvenciális módban jön létre.

Ha nincs megadva szekvenciális mód, minden oszlopértéknek elérhetővé kell válnia a memóriában minden alkalommal, amikor a ReadAsync befejeződik, és a metódus szinkron verziójának meghívása nem blokkolja a hívó szálat.

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.

GetFieldValueAsync<T>(Int32, CancellationToken)

Forrás:

DbDataReader.cs

Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.

public:
generic <typename T>
 virtual System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<T> GetFieldValueAsync<T>(int ordinal, System.Threading.CancellationToken cancellationToken);

abstract member GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

Típusparaméterek

T

A visszaadandó érték típusa.

Paraméterek

ordinal

Int32

A nulla alapú oszloprend.

cancellationToken

CancellationToken

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

Válaszok

Task<T>

Olyan tevékenység, amely Result a megadott oszlop értékét tartalmazza.

Kivételek

InvalidOperationException

A kapcsolat megszakadt vagy megszakadt az adatlekérés során.

-vagy-

Az adatolvasó az adatlekérés során bezárult.

-vagy-

Nincs olvasásra kész adat (például az első Read() nem lett meghívva, vagy vissza lett adva false).

-vagy-

Megpróbált beolvasni egy korábban beolvasott oszlopot szekvenciális módban.

-vagy-

Aszinkron művelet volt folyamatban. Ez az összes Get_*_ metódusra vonatkozik, ha szekvenciális módban futnak, mivel a stream olvasása közben meghívhatók.

IndexOutOfRangeException

Az oszlopindex tartományon kívül esik.

InvalidCastException

Az adatbázis által visszaadott érték nem egyezik meg vagy nem vethető be.T

OperationCanceledException

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

Megjegyzések

Ez az aszinkron módszer csak azért szükséges, hogy elkerülje a hívó szál blokkolását, amikor az olvasó szekvenciális módban jön létre.

Ha nincs megadva szekvenciális mód, minden oszlopértéknek elérhetővé kell válnia a memóriában minden alkalommal, amikor a ReadAsync befejeződik, és a metódus szinkron verziójának meghívása nem blokkolja a hívó szálat.

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.