SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Uma versão assíncrona de IsDBNull(Int32), que recebe um valor que indica se a coluna contém valores inexistentes ou em falta.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
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)Parâmetros
- i
- Int32
A coluna de base zero a recuperar.
- cancellationToken
- CancellationToken
A instrução de cancelamento, que propaga uma notificação de que as operações devem ser canceladas. Isto não garante o cancelamento. Um ajuste de CancellationToken.None torna este método equivalente a IsDBNull(Int32). A tarefa devolvida deve ser marcada como cancelada.
Devoluções
true se o valor da coluna especificado for equivalente a DBNull caso falsecontrário .
Exceções
A ligação cai ou é encerrada durante a recuperação dos dados.
O SqlDataReader é fechado durante a recuperação dos dados.
Não há dados prontos para serem lidos (por exemplo, o primeiro Read() não foi chamado ou devolveu falso).
A tentar ler uma coluna previamente lida em modo sequencial.
Estava em curso uma operação assíncrona. Isto aplica-se a todos os métodos Get* quando executados em modo sequencial, pois podem ser chamados ao ler um fluxo.
Context Connection=true está especificado no cadeia de ligação.
Tentar ler uma coluna que não existe.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações, consulte Suporte de Transmissão SQLClient.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por IsDBNull(Int32).