SqlCommand.ExecuteXmlReaderAsync 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 e retorna os resultados como um objeto XmlReader.
Sobrecargas
| Name | Description |
|---|---|
| ExecuteXmlReaderAsync() |
Uma versão assíncrona de ExecuteXmlReader(), que envia o CommandText para o Connection e constrói um XmlReader objeto. As exceções serão reportadas através do objeto Task devolvido. |
| ExecuteXmlReaderAsync(CancellationToken) |
Uma versão assíncrona de ExecuteXmlReader(), que envia o CommandText para o Connection e constrói um XmlReader objeto. 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. |
ExecuteXmlReaderAsync()
Uma versão assíncrona de ExecuteXmlReader(), que envia o CommandText para o Connection e constrói um XmlReader objeto.
As exceções serão reportadas através do objeto Task devolvido.
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync();member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)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.
Chamar ExecuteScalarAsync(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.
Observações
O XmlReader devolvido por este método não suporta operações assíncronas.
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 ExecuteXmlReader().
Ver também
Aplica-se a
ExecuteXmlReaderAsync(CancellationToken)
Uma versão assíncrona de ExecuteXmlReader(), que envia o CommandText para o Connection e constrói um XmlReader objeto.
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::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync(System.Threading.CancellationToken cancellationToken);member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)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.
Chamar ExecuteScalarAsync(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
O XmlReader devolvido por este método não suporta operações assíncronas.
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 ExecuteXmlReader().