SqlCommand.EndExecuteNonQuery(IAsyncResult) Метод

Ссылка

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.dll

Сборки:: netstandard.dll, System.Data.SqlClient.dll

Пакет:: System.Data.SqlClient v4.8.6

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Завершает асинхронное выполнение инструкции Transact-SQL.

public:
 int EndExecuteNonQuery(IAsyncResult ^ asyncResult);

public int EndExecuteNonQuery (IAsyncResult asyncResult);

member this.EndExecuteNonQuery : IAsyncResult -> int

Public Function EndExecuteNonQuery (asyncResult As IAsyncResult) As Integer

Параметры

asyncResult: IAsyncResult

Объект IAsyncResult, возвращенный из вызова BeginExecuteNonQuery().

Возвращаемое значение

Int32

Количество задействованных строк (аналогично ExecuteNonQuery()).

Исключения

ArgumentException

Параметр asyncResult имеет значение NULL (Nothing в Microsoft Visual Basic).

InvalidOperationException

EndExecuteNonQuery(IAsyncResult) вызывался более одного раза для одиночного выполнения команды, или неправильно подобран метод для его метода выполнения (например, код вызвал EndExecuteNonQuery(IAsyncResult) для завершения выполнения вызова в BeginExecuteXmlReader().

SqlException

Время, указанное в CommandTimeout, истекло, а асинхронная операция, указанная с BeginExecuteNonQuery, не завершена.

-или-

В некоторых ситуациях для IAsyncResult может быть ошибочно задано значение IsCompleted. Если это произошло и вызывается EndExecuteNonQuery(IAsyncResult), метод EndExecuteNonQuery может вызвать ошибку SqlException, если время, указанное в CommandTimeout, истекло, а асинхронная операция, указанная с BeginExecuteNonQuery, не завершена. Чтобы исправить эту ситуацию, следует увеличить значение CommandTimeout или уменьшить объем обработки, выполняемой асинхронной операцией.

Примеры

Примеры, демонстрирующие использование метода , см. в EndExecuteNonQuery разделе BeginExecuteNonQuery.

При вызове BeginExecuteNonQuery для выполнения инструкции Transact-SQL необходимо вызвать EndExecuteNonQuery , чтобы завершить операцию. Если процесс выполнения команды еще не завершен, этот метод блокируется до завершения операции. Пользователи могут убедиться, что команда завершила свою операцию, используя экземпляр, IAsyncResult возвращенный методом BeginExecuteNonQuery . Если в вызове BeginExecuteNonQueryуказана процедура обратного вызова , необходимо вызвать этот метод.

Применяется к

Поделиться через