DbDataReader.IsDBNullAsync Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.

Túlterhelések

Name	Description
IsDBNullAsync(Int32)	Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.
IsDBNullAsync(Int32, CancellationToken)	Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.

IsDBNullAsync(Int32)

Forrás:

DbDataReader.cs

Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.

public:
 System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal);

public System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal);

member this.IsDBNullAsync : int -> System.Threading.Tasks.Task<bool>

Public Function IsDBNullAsync (ordinal As Integer) As Task(Of Boolean)

Paraméterek

ordinal

Int32

A lekérendő nulla alapú oszlop.

Válaszok

Task<Boolean>

Az Task<TResult> a tulajdonság, amelynek Result a true tulajdonsága, ha a megadott oszlopérték egyenértékű vagy DBNullfalse nem.

Kivételek

InvalidOperationException

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

-vagy-

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

-vagy-

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

-vagy-

Egy korábban beolvasott oszlop olvasása 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.

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.

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

IsDBNullAsync(Int32, CancellationToken)

Forrás:

DbDataReader.cs

Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.

public:
 virtual System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

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

abstract member IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Paraméterek

ordinal

Int32

A lekérendő nulla alapú oszlop.

cancellationToken

CancellationToken

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

Válaszok

Task<Boolean>

Az Task<TResult> a tulajdonság, amelynek Result a true tulajdonsága, ha a megadott oszlopérték egyenértékű vagy DBNullfalse nem.

Kivételek

InvalidOperationException

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

-vagy-

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

-vagy-

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

-vagy-

Egy korábban beolvasott oszlop olvasása 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.

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