DbDataReader.IsDBNullAsync Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

Overload

IsDBNullAsync(Int32)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.
IsDBNullAsync(Int32, CancellationToken)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

IsDBNullAsync(Int32)

Source:

DbDataReader.cs

Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

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)

Parametri

ordinal

Int32

Colonna in base zero da recuperare.

Restituisce

Task<Boolean>

Task<TResult> la cui proprietà Result è true se il valore della colonna specificata è equivalente a DBNull o false in caso contrario.

Eccezioni

InvalidOperationException

La connessione è stata eliminata o chiusa durante il recupero dei dati.

-oppure-

Il lettore dati viene chiuso durante il recupero dei dati.

-oppure-

Non sono disponibili dati pronti per essere letti (ad esempio, il primo Read() non è stato chiamato, o è stato restituito false).

-oppure-

Tentativo di leggere una colonna letta in precedenza in modalità sequenziale.

-oppure-

Operazione asincrona in corso. Si applica a tutti i metodi Get* durante l'esecuzione in modalità sequenziale, in quanto possono essere chiamati durante la lettura di un flusso.

IndexOutOfRangeException

L'indice di colonna non è compreso nell'intervallo.

Commenti

Questo metodo asincrono è necessario solo per evitare di bloccare il thread chiamante quando il lettore viene creato in modalità sequenziale.

Se la modalità sequenziale non viene specificata, tutti i valori di colonna devono diventare disponibili in memoria ogni volta che ReadAsync viene completato e la chiamata alla versione sincrona del metodo non deve bloccare il thread chiamante.

L'implementazione predefinita di questo metodo asincrono richiama la controparte sincrona e restituisce un'attività completata, bloccando potenzialmente il thread chiamante.

I provider di dati che supportano la programmazione asincrona devono eseguire l'override dell'implementazione predefinita usando operazioni di I/O asincrone.

Non si devono richiamare altri metodi e proprietà dell'oggetto DbDataReader mentre l'attività restituita non è ancora completata.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da IsDBNull(Int32).

IsDBNullAsync(Int32, CancellationToken)

Source:

DbDataReader.cs

Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

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)

Parametri

ordinal

Int32

Colonna in base zero da recuperare.

cancellationToken

CancellationToken

Token per annullare l'operazione asincrona.

Restituisce

Task<Boolean>

Task<TResult> la cui proprietà Result è true se il valore della colonna specificata è equivalente a DBNull o false in caso contrario.

Eccezioni

InvalidOperationException

La connessione è stata eliminata o chiusa durante il recupero dei dati.

-oppure-

Il lettore dati viene chiuso durante il recupero dei dati.

-oppure-

Non sono disponibili dati pronti per essere letti (ad esempio, il primo Read() non è stato chiamato, o è stato restituito false).

-oppure-

Tentativo di leggere una colonna letta in precedenza in modalità sequenziale.

-oppure-

Operazione asincrona in corso. Si applica a tutti i metodi Get* durante l'esecuzione in modalità sequenziale, in quanto possono essere chiamati durante la lettura di un flusso.

IndexOutOfRangeException

L'indice di colonna non è compreso nell'intervallo.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo asincrono è necessario solo per evitare di bloccare il thread chiamante quando il lettore viene creato in modalità sequenziale.

Se la modalità sequenziale non viene specificata, tutti i valori di colonna devono diventare disponibili in memoria ogni volta che ReadAsync viene completato e la chiamata alla versione sincrona del metodo non deve bloccare il thread chiamante.

L'implementazione predefinita di questo metodo asincrono richiama la controparte sincrona e restituisce un'attività completata, bloccando potenzialmente il thread chiamante. L'implementazione predefinita restituisce anche un'attività annullata se è stato passato un token di annullamento già annullato.

I provider di dati che supportano la programmazione asincrona devono eseguire l'override dell'implementazione predefinita usando operazioni di I/O asincrone.

Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo. Le implementazioni possono ignorare la richiesta.

Non si devono richiamare altri metodi e proprietà dell'oggetto DbDataReader mentre l'attività restituita non è ancora completata. Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da IsDBNull(Int32).