SqlDataReader.ReadAsync(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 Read(), que avança para o SqlDataReader registo seguinte.
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> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar ReadAsync(CancellationToken) mais do que uma vez para a mesma instância antes da conclusão da tarefa.
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Se o behavior parâmetro de ExecuteReaderAsync estiver definido para Default, ReadAsync lê toda a linha antes de devolver a Tarefa.
Para mais informações, incluindo exemplos de código, sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
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 Read().