SqlCommand.EndExecuteNonQuery(IAsyncResult) 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.
Conclui 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 retornado pela chamada para BeginExecuteNonQuery().
Retornos
O número de linhas afetadas (o mesmo comportamento que ExecuteNonQuery()).
Exceções
asyncResult parâmetro é nulo (Nothing no Microsoft Visual Basic)
EndExecuteNonQuery(IAsyncResult) foi chamado mais de uma vez para uma única execução de comando ou o método foi incompatível com seu método de execução (por exemplo, o código chamado EndExecuteNonQuery(IAsyncResult) para concluir a execução de uma chamada para BeginExecuteXmlReader().
A quantidade de tempo especificada em CommandTimeout decorrido e a operação assíncrona especificada com BeginExecuteNonQuery não está concluída.
-ou-
Em algumas situações, IAsyncResult pode ser definido como IsCompleted incorretamente. Se isso ocorrer e EndExecuteNonQuery(IAsyncResult) for chamado, EndExecuteNonQuery poderá gerar um erro SqlException se a quantidade de tempo especificada em CommandTimeout decorrido e a operação assíncrona especificada com BeginExecuteNonQuery não estiver concluída. Para corrigir essa situação, você deve aumentar o valor de CommandTimeout ou reduzir o trabalho que está sendo feito pela operação assíncrona.
Exemplos
Para obter exemplos que demonstram o uso do EndExecuteNonQuery método, consulte BeginExecuteNonQuery.
Comentários
Ao chamar BeginExecuteNonQuery para executar uma instrução Transact-SQL, você deve chamar EndExecuteNonQuery para concluir a operação. Se o processo de execução do comando ainda não tiver sido concluído, esse método será bloqueado até que a operação seja concluída. Os usuários podem verificar se o comando concluiu sua operação usando a IAsyncResult instância retornada pelo BeginExecuteNonQuery método. Se um procedimento de retorno de chamada tiver sido especificado na chamada, BeginExecuteNonQueryesse método deverá ser chamado.