SqlCommand.EndExecuteNonQuery(IAsyncResult) 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.
Termina a execução assíncrona de uma instrução Transact-SQL.
public:
int EndExecuteNonQuery(IAsyncResult ^ asyncResult);public int EndExecuteNonQuery(IAsyncResult asyncResult);member this.EndExecuteNonQuery : IAsyncResult -> intPublic Function EndExecuteNonQuery (asyncResult As IAsyncResult) As IntegerParâmetros
- asyncResult
- IAsyncResult
O IAsyncResult retornou pela chamada para BeginExecuteNonQuery().
Devoluções
O número de linhas afetadas (o mesmo comportamento que ExecuteNonQuery()).
Exceções
EndExecuteNonQuery(IAsyncResult) foi chamado mais do que uma vez para a execução de um único comando, ou o método foi incompatível com o seu método de execução (por exemplo, o código chamado EndExecuteNonQuery(IAsyncResult) para completar a execução de uma chamada para BeginExecuteXmlReader().
O tempo especificado em CommandTimeout decorrido e a operação assíncrona especificada com BeginExecuteNonQuery não está completo.
-ou-
Em algumas situações, IAsyncResult pode estar configurado incorretamente IsCompleted . Se isto ocorrer e EndExecuteNonQuery(IAsyncResult) for chamado, o EndExecuteNonQuery pode gerar um erro SqlException se o tempo especificado em CommandTimeout decorrer e a operação assíncrona especificada com BeginExecuteNonQuery não estiver completa. Para corrigir esta situação, deve aumentar o valor do CommandTimeout ou reduzir o trabalho realizado pela operação assíncrona.
Exemplos
Para exemplos que demonstram a utilização do EndExecuteNonQuery método, veja BeginExecuteNonQuery.
Observações
Quando chama BeginExecuteNonQuery para executar uma instrução Transact-SQL, deve chamar EndExecuteNonQuery para completar a operação. Se o processo de execução do comando ainda não terminar, este método bloqueia-se até que a operação seja concluída. Os utilizadores podem verificar que o comando completou a sua operação usando a IAsyncResult instância devolvida pelo BeginExecuteNonQuery método. Se um procedimento de callback foi especificado na chamada para BeginExecuteNonQuery, este método deve ser chamado.