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


SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Метод

Определение

Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях keys, values и oldValues.

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Параметры

keys
IDictionary

Объект IDictionary первичных ключей, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один ключ или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

values
IDictionary

Объект IDictionary значений, используемых вместе со свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

oldValues
IDictionary

Объект IDictionary, предоставляющий исходные значения в базе данных. Если с запросом не связан ни один параметр или если свойство UpdateCommand не является параметризованным SQL-запросом, передает значение null.

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

Значение, представляющее число строк, обновленных в основной базе данных.

Исключения

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.

-или-

Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.

У текущего пользователя нет надлежащих прав для получения доступа к базе данных.

Значение свойства CanUpdatefalse.

Комментарии

Класс SqlDataSourceView реализует наследуемый ExecuteUpdate метод для обновления данных в базе данных. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteUpdate метод напрямую. Вместо этого используйте открытый Update метод.

Значения, содержащиеся в коллекциях keys и values , вычисляются и объединяются со значениями, содержащимися в UpdateParameters коллекции. Если свойству ConflictDetection присвоено значение CompareAllValues, значения, содержащиеся в oldValues коллекции, форматируются с OldValuesParameterFormatString и также объединяются.

Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед обновлением.

Для выполнения операции SqlDataSourceView создается DbCommand объект с использованием UpdateCommand текста и всех связанных UpdateParameters свойств, а затем выполняет объект в DbCommand базовой базе данных. После завершения OnUpdated операции вызывается метод для вызова Updated события . Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.

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

См. также раздел