SqlCommand.ExecuteReaderAsync 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.
Inicia a execução assíncrona da instrução Transact-SQL ou procedimento armazenado descrito por este SqlCommand.
Sobrecargas
| Name | Description |
|---|---|
| ExecuteReaderAsync() |
Uma versão assíncrona de ExecuteReader(), que envia o CommandText para o Connection e constrói um SqlDataReader. As exceções serão reportadas através do objeto Task devolvido. |
| ExecuteReaderAsync(CommandBehavior) |
Uma versão assíncrona de ExecuteReader(CommandBehavior), que envia o CommandText para o Connection, e constrói um SqlDataReader. As exceções serão reportadas através do objeto Task devolvido. |
| ExecuteReaderAsync(CancellationToken) |
Uma versão assíncrona de ExecuteReader(), que envia o CommandText para o Connection e constrói um SqlDataReader. 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. |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Uma versão assíncrona de ExecuteReader(CommandBehavior), que envia o CommandText para o Connection, e constrói um SqlDataReader 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. |
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
ExecuteReaderAsync()
Uma versão assíncrona de ExecuteReader(), que envia o CommandText para o Connection e constrói um SqlDataReader. As exceções serão reportadas através do objeto Task devolvido.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Um SqlDbType diferente de Binary ou VarBinary era usado quando Value estava definido para Stream. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou XML era usado quando Value estava definido para TextReader.
-ou-
Um SqlDbType outro que não XML era usado quando Value estava definido para XmlReader.
Um valor inválido CommandBehavior .
Chamar ExecuteReaderAsync() mais do que uma vez para a mesma instância antes da conclusão da tarefa.
-ou-
Fecharam SqlConnection ou caíram durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
-ou-
Ocorreu um tempo durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Ocorreu um erro num Stream, XmlReader ou TextReader objeto durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O Stream, XmlReader ou TextReader objeto era fechado durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Observações
Para mais informações 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 ExecuteReader().
Ver também
Aplica-se a
ExecuteReaderAsync(CommandBehavior)
Uma versão assíncrona de ExecuteReader(CommandBehavior), que envia o CommandText para o Connection, e constrói um SqlDataReader. As exceções serão reportadas através do objeto Task devolvido.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)Parâmetros
- behavior
- CommandBehavior
Opções para execução de instruções e recuperação de dados. Quando está definido para Default, ReadAsync(CancellationToken) lê toda a linha antes de devolver uma tarefa completa.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Um SqlDbType diferente de Binary ou VarBinary era usado quando Value estava definido para Stream. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou XML era usado quando Value estava definido para TextReader.
-ou-
Um SqlDbType outro que não XML era usado quando Value estava definido para XmlReader.
Um valor inválido CommandBehavior .
Chamar ExecuteReaderAsync(CommandBehavior) mais do que uma vez para a mesma instância antes da conclusão da tarefa.
-ou-
Fecharam SqlConnection ou caíram durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
-ou-
Ocorreu um tempo durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Ocorreu um erro num Stream, XmlReader ou TextReader objeto durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O Stream, XmlReader ou TextReader objeto era fechado durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Observações
Para mais informações 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 ExecuteReader(CommandBehavior).
Ver também
Aplica-se a
ExecuteReaderAsync(CancellationToken)
Uma versão assíncrona de ExecuteReader(), que envia o CommandText para o Connection e constrói um SqlDataReader.
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:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)Parâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Um SqlDbType diferente de Binary ou VarBinary era usado quando Value estava definido para Stream. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou XML era usado quando Value estava definido para TextReader.
-ou-
Um SqlDbType outro que não XML era usado quando Value estava definido para XmlReader.
Um valor inválido CommandBehavior .
Chamar ExecuteReaderAsync(CommandBehavior, CancellationToken) mais do que uma vez para a mesma instância antes da conclusão da tarefa.
-ou-
Fecharam SqlConnection ou caíram durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
-ou-
Ocorreu um tempo durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Ocorreu um erro num Stream, XmlReader ou TextReader objeto durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O Stream, XmlReader ou TextReader objeto era fechado durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações 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 ExecuteReader().
Ver também
Aplica-se a
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Uma versão assíncrona de ExecuteReader(CommandBehavior), que envia o CommandText para o Connection, e constrói um SqlDataReader
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:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)Parâmetros
- behavior
- CommandBehavior
Opções para execução de instruções e recuperação de dados. Quando está definido para Default, ReadAsync(CancellationToken) lê toda a linha antes de devolver uma tarefa completa.
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Um SqlDbType diferente de Binary ou VarBinary era usado quando Value estava definido para Stream. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Um SqlDbType diferente de Char, NChar, NVarChar, VarChar ou XML era usado quando Value estava definido para TextReader.
-ou-
Um SqlDbType outro que não XML era usado quando Value estava definido para XmlReader.
Um valor inválido CommandBehavior .
Chamar ExecuteReaderAsync(CommandBehavior, CancellationToken) mais do que uma vez para a mesma instância antes da conclusão da tarefa.
-ou-
Fecharam SqlConnection ou caíram durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
-ou-
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
-ou-
Ocorreu um tempo durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
Ocorreu um erro num Stream, XmlReader ou TextReader objeto durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O Stream, XmlReader ou TextReader objeto era fechado durante uma operação de streaming. Para mais informações sobre streaming, consulte SqlClient Streaming Support.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações 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 ExecuteReader(CommandBehavior).