DbDataReader.ReadAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.
Sobrecargas
| ReadAsync() |
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados. |
| ReadAsync(CancellationToken) |
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados. |
Comentários
Para obter mais informações sobre programação assíncrona, consulte Programação assíncrona.
ReadAsync()
- Origem:
- DbDataReader.cs
- Origem:
- DbDataReader.cs
- Origem:
- DbDataReader.cs
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.
public:
System::Threading::Tasks::Task<bool> ^ ReadAsync();public System.Threading.Tasks.Task<bool> ReadAsync ();member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>Public Function ReadAsync () As Task(Of Boolean)Retornos
Um Task<TResult> cuja propriedade Result será true se houver mais linhas de resultados ou false se não houver.
Exceções
Ocorreu um erro ao executar o texto do comando.
Comentários
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.
Os provedores de dados que dão suporte à programação assíncrona devem substituir a implementação padrão usando operações de E/S assíncronas.
Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Read().
Confira também
Aplica-se a
ReadAsync(CancellationToken)
- Origem:
- DbDataReader.cs
- Origem:
- DbDataReader.cs
- Origem:
- DbDataReader.cs
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.
public:
virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Retornos
Um Task<TResult> cuja propriedade Result será true se houver mais linhas de resultados ou false se não houver.
Exceções
Ocorreu um erro ao executar o texto do comando.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
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. A implementação padrão também retornará uma tarefa cancelada se for aprovada um token de cancelamento já cancelado.
Os provedores de dados que dão suporte à programação assíncrona devem substituir a implementação padrão usando operações de E/S assíncronas.
Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. As implementações podem ignorar essa solicitação.
Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Read().
