DbDataReader.IsDBNullAsync Método

Definição

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Sobrecargas

IsDBNullAsync(Int32)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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)

Parâmetros

ordinal
Int32

A coluna com base em zero a ser recuperada.The zero-based column to be retrieved.

Retornos

Task<Boolean>

Um Task<TResult> cuja propriedade Result será true se o valor da coluna especificada for equivalente a DBNull ou será false se não for.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Exceções

A conexão caiu ou foi fechada durante a recuperação de dados.The connection was dropped or closed during the data retrieval.

- ou --or-

O leitor de dados é fechado durante a recuperação de dados.The data reader is closed during the data retrieval.

- ou --or-

Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornou false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- ou --or-

Tentando ler uma coluna lida anteriormente no modo sequencial.Trying to read a previously read column in sequential mode.

- ou --or-

Havia uma operação assíncrona em andamento.There was an asynchronous operation in progress. Isso se aplica a todos os métodos Get* executados no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

O índice da coluna está fora do intervalo.The column index is out of range.

Comentários

Esse método assíncrono só é necessário para evitar o bloqueio do thread de chamada quando o leitor é criado no modo sequencial.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Se o modo sequencial não for especificado, todos os valores de coluna deverão ser disponibilizados na memória toda vez que o ReadAsync for concluído e chamar a versão síncrona do método não deverá bloquear o thread de chamada.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

A implementação padrão desse método assíncrono invoca sua contraparte síncrona e retorna uma tarefa concluída, potencialmente bloqueando o thread de chamada.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Os provedores de dados que oferecem suporte à programação assíncrona devem substituir a implementação padrão usando operações de e/s assíncronas.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Aplica-se a

IsDBNullAsync(Int32, CancellationToken)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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)

Parâmetros

ordinal
Int32

A coluna com base em zero a ser recuperada.The zero-based column to be retrieved.

cancellationToken
CancellationToken

Um token para cancelar a operação assíncrona.A token to cancel the asynchronous operation.

Retornos

Task<Boolean>

Um Task<TResult> cuja propriedade Result será true se o valor da coluna especificada for equivalente a DBNull ou será false se não for.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Exceções

A conexão caiu ou foi fechada durante a recuperação de dados.The connection was dropped or closed during the data retrieval.

- ou --or-

O leitor de dados é fechado durante a recuperação de dados.The data reader is closed during the data retrieval.

- ou --or-

Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou retornou false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- ou --or-

Tentando ler uma coluna lida anteriormente no modo sequencial.Trying to read a previously read column in sequential mode.

- ou --or- Havia uma operação assíncrona em andamento.There was an asynchronous operation in progress. Isso se aplica a todos os métodos Get* executados no modo sequencial, pois eles podem ser chamados durante a leitura de um fluxo.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

O índice da coluna está fora do intervalo.The column index is out of range.

Comentários

Esse método assíncrono só é necessário para evitar o bloqueio do thread de chamada quando o leitor é criado no modo sequencial.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Se o modo sequencial não for especificado, todos os valores de coluna deverão ser disponibilizados na memória toda vez que o ReadAsync for concluído e chamar a versão síncrona do método não deverá bloquear o thread de chamada.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

A implementação padrão desse método assíncrono invoca sua contraparte síncrona e retorna uma tarefa concluída, potencialmente bloqueando o thread de chamada.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. A implementação padrão também retornará uma tarefa cancelada se tiver passado um token de cancelamento já cancelado.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Os provedores de dados que oferecem suporte à programação assíncrona devem substituir a implementação padrão usando operações de e/s assíncronas.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início.This method accepts a cancellation token that can be used to request the operation to be cancelled early. As implementações podem ignorar essa solicitação.Implementations may ignore this request.

Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Aplica-se a