SqlCommand.EndExecuteNonQuery(IAsyncResult) SqlCommand.EndExecuteNonQuery(IAsyncResult) SqlCommand.EndExecuteNonQuery(IAsyncResult) SqlCommand.EndExecuteNonQuery(IAsyncResult) Method

Définition

Termine l'exécution asynchrone d'une instruction Transact-SQL.Finishes asynchronous execution of a Transact-SQL statement.

public:
 int EndExecuteNonQuery(IAsyncResult ^ asyncResult);
public int EndExecuteNonQuery (IAsyncResult asyncResult);
member this.EndExecuteNonQuery : IAsyncResult -> int
Public Function EndExecuteNonQuery (asyncResult As IAsyncResult) As Integer

Paramètres

Retours

Nombre de lignes affectées (comportement identique à ExecuteNonQuery()).The number of rows affected (the same behavior as ExecuteNonQuery()).

Exceptions

Le paramètre asyncResult a la valeur null (Nothing dans Microsoft Visual Basic)asyncResult parameter is null (Nothing in Microsoft Visual Basic)

EndExecuteNonQuery(IAsyncResult) a été appelé plusieurs fois pour une exécution de commande unique, ou la méthode est incompatible avec sa méthode d’exécution (par exemple, le code a appelé EndExecuteNonQuery(IAsyncResult) pour terminer l’exécution d’un appel à BeginExecuteXmlReader().EndExecuteNonQuery(IAsyncResult) was called more than once for a single command execution, or the method was mismatched against its execution method (for example, the code called EndExecuteNonQuery(IAsyncResult) to complete execution of a call to BeginExecuteXmlReader().

La durée spécifiée dans CommandTimeout s’est écoulée, et l’opération asynchrone spécifiée avec BeginExecuteNonQuery n’est pas terminée.The amount of time specified in CommandTimeout elapsed and the asynchronous operation specified with BeginExecuteNonQuery is not complete.

- ou --or-

Dans certaines situations, la valeur IsCompleted peut-être affectée à IAsyncResult de manière incorrecte.In some situations, IAsyncResult can be set to IsCompleted incorrectly. Si cela se produit et que EndExecuteNonQuery(IAsyncResult) est appelé, EndExecuteNonQuery peut générer une erreur SqlException si la durée spécifiée dans CommandTimeout s’est écoulée et que l’opération asynchrone spécifiée avec BeginExecuteNonQuery n’est pas terminée.If this occurs and EndExecuteNonQuery(IAsyncResult) is called, EndExecuteNonQuery could raise a SqlException error if the amount of time specified in CommandTimeout elapsed and the asynchronous operation specified with BeginExecuteNonQuery is not complete. Pour corriger cette situation, vous devez augmenter la valeur de CommandTimeout ou réduire le travail effectué par l’opération asynchrone.To correct this situation, you should either increase the value of CommandTimeout or reduce the work being done by the asynchronous operation.

Exemples

Pour obtenir des exemples illustrant l’utilisation EndExecuteNonQuery de la méthode BeginExecuteNonQuery, consultez.For examples demonstrating the use of the EndExecuteNonQuery method, see BeginExecuteNonQuery.

Remarques

Lorsque vous appelez BeginExecuteNonQuery pour exécuter une Transact-SQLTransact-SQL instruction, vous devez appeler EndExecuteNonQuery pour terminer l’opération.When you call BeginExecuteNonQuery to execute a Transact-SQLTransact-SQL statement, you must call EndExecuteNonQuery in order to complete the operation. Si le processus d’exécution de la commande n’est pas encore terminé, cette méthode se bloque jusqu’à ce que l’opération soit terminée.If the process of executing the command has not yet finished, this method blocks until the operation is complete. Les utilisateurs peuvent vérifier que la commande a terminé son opération à l' IAsyncResult aide de l’instance BeginExecuteNonQuery retournée par la méthode.Users can verify that the command has completed its operation by using the IAsyncResult instance returned by the BeginExecuteNonQuery method. Si une procédure de rappel a été spécifiée dans l' BeginExecuteNonQueryappel à, cette méthode doit être appelée.If a callback procedure was specified in the call to BeginExecuteNonQuery, this method must be called.

S’applique à

Voir aussi