DbDataReader.IsDBNullAsync Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

Přetížení

IsDBNullAsync(Int32)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
IsDBNullAsync(Int32, CancellationToken)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

IsDBNullAsync(Int32)

Zdroj:

DbDataReader.cs

Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

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)

Parametry

ordinal

Int32

Sloupec založený na nule, který se má načíst.

Návraty

Task<Boolean>

Vlastnost Task<TResult> , jejíž Result vlastnost je true , pokud je zadaná hodnota sloupce ekvivalentní hodnotě DBNull nebo false pokud není.

Výjimky

InvalidOperationException

Připojení bylo během načítání dat ukončeno nebo ukončeno.

-nebo-

Čtečka dat se během načítání dat zavře.

-nebo-

Nejsou připravená žádná data ke čtení (například první Read() nebyla volána nebo vrácena false).

-nebo-

Pokus o čtení dříve přečtený sloupec v sekvenčním režimu

-nebo-

Probíhala asynchronní operace. To platí pro všechny metody Get* při spuštění v sekvenčním režimu, protože je možné je volat při čtení streamu.

IndexOutOfRangeException

Index sloupce je mimo rozsah.

Poznámky

Tato asynchronní metoda je potřebná pouze k tomu, aby se zabránilo blokování volajícího vlákna při vytváření čtečky v sekvenčním režimu.

Pokud není zadaný sekvenční režim, měly by být všechny hodnoty sloupců dostupné v paměti při každém dokončení readAsync a volání synchronní verze metody by nemělo blokovat volající vlákno.

Výchozí implementace této asynchronní metody vyvolá její synchronní protějšek a vrátí dokončenou úlohu, potenciálně blokuje volající vlákno.

Zprostředkovatelé dat, kteří podporují asynchronní programování , by měli přepsat výchozí implementaci pomocí asynchronních vstupně-výstupních operací.

Jiné metody a vlastnosti DbDataReader objektu by neměly být vyvolány, pokud vrácená úloha ještě není dokončena.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem IsDBNull(Int32).

IsDBNullAsync(Int32, CancellationToken)

Zdroj:

DbDataReader.cs

Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

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)

Parametry

ordinal

Int32

Sloupec založený na nule, který se má načíst.

cancellationToken

CancellationToken

Token pro zrušení asynchronní operace.

Návraty

Task<Boolean>

Vlastnost Task<TResult> , jejíž Result vlastnost je true , pokud je zadaná hodnota sloupce ekvivalentní hodnotě DBNull nebo false pokud není.

Výjimky

InvalidOperationException

Připojení bylo během načítání dat ukončeno nebo ukončeno.

-nebo-

Čtečka dat se během načítání dat zavře.

-nebo-

Nejsou připravená žádná data ke čtení (například první Read() nebyla volána nebo vrácena false).

-nebo-

Pokus o čtení dříve přečtený sloupec v sekvenčním režimu

-nebo-

Probíhala asynchronní operace. To platí pro všechny metody Get* při spuštění v sekvenčním režimu, protože je možné je volat při čtení streamu.

IndexOutOfRangeException

Index sloupce je mimo rozsah.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato asynchronní metoda je potřebná pouze k tomu, aby se zabránilo blokování volajícího vlákna při vytváření čtečky v sekvenčním režimu.

Pokud není zadaný sekvenční režim, měly by být všechny hodnoty sloupců dostupné v paměti při každém dokončení readAsync a volání synchronní verze metody by nemělo blokovat volající vlákno.

Výchozí implementace této asynchronní metody vyvolá její synchronní protějšek a vrátí dokončenou úlohu, potenciálně blokuje volající vlákno. Výchozí implementace také vrátí zrušenou úlohu, pokud byl předán již zrušený token zrušení.

Zprostředkovatelé dat, kteří podporují asynchronní programování , by měli přepsat výchozí implementaci pomocí asynchronních vstupně-výstupních operací.

Tato metoda přijímá token zrušení, který lze použít k žádosti o předčasné zrušení operace. Implementace můžou tento požadavek ignorovat.

Jiné metody a vlastnosti DbDataReader objektu by neměly být vyvolány, pokud vrácená úloha ještě není dokončena. Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem IsDBNull(Int32).