SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.9.0

Zdroj:

System.Data.SqlClient.notsupported.cs

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

Token zrušení lze použít k vyžádání, aby byla operace zrušena před vypršením časového limitu příkazu. Výjimky budou hlášeny prostřednictvím vráceného objektu Task.

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

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

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

Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

i

Int32

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

cancellationToken

CancellationToken

Instrukce zrušení, která šíří oznámení, že operace by měly být zrušeny. Zrušení tak není zaručeno. Nastavení způsobí, CancellationToken.None že tato metoda bude ekvivalentní hodnotě IsDBNull(Int32). Vrácený úkol musí být označen jako zrušený.

Návraty

Task<Boolean>

true pokud je zadaná hodnota sloupce ekvivalentní jiné hodnotě DBNullfalse.

Výjimky

InvalidOperationException

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

Během SqlDataReader načítání dat se zavře.

Nejsou připravená žádná data ke čtení (první se například Read() nevolala nebo nevrátila hodnotu false).

Pokus o přečtení dříve přečteného sloupce v sekvenčním režimu

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

Context Connection=trueje zadaný v připojovací řetězec.

IndexOutOfRangeException

Pokoušíte se přečíst sloupec, který neexistuje.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Další informace najdete v tématu Podpora streamování SqlClient.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem IsDBNull(Int32).