ObjectDataSourceView.ExecuteUpdate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию обновления путем вызова метода, заданного свойством UpdateMethod, используя при этом все параметры, предоставленные в коллекциях 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 -> intProtected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As IntegerПараметры
- keys
- IDictionary
Объект IDictionary первичных ключей, используемых вместе со свойством UpdateMethod для выполнения операции обновления базы данных. Если с методом не связан ни один ключ, возвращается значение null.
- values
- IDictionary
Объект IDictionary значений, который следует использовать вместе со свойством UpdateMethod для выполнения операции обновления базы данных. Если с методом не связан ни один параметр, возвращается значение null.
- oldValues
- IDictionary
Объект IDictionary, предоставляющий исходные значения в базовом хранилище данных. Если с запросом не связан ни один параметр, возвращается значение null.
Возвращаемое значение
Число подлежащих обновлению строк или -1, если число неизвестно. Для получения дополнительной информации см. Update().
Исключения
Свойство CanInsert возвращает значение false.
Значение параметра oldValues равно null или этот параметр пуст, а свойству ConflictDetection присвоено значение CompareAllValues.
Комментарии
Класс ObjectDataSourceView реализует унаследованный ExecuteUpdate метод для обновления данных с помощью бизнес-объекта . Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteUpdate метод напрямую, а используют открытый Update метод.
Значения, содержащиеся в коллекциях и values , вычисляются и объединяются со значениями, содержащимися в keysUpdateParameters коллекции. Если свойству ConflictDetection присвоено CompareAllValues значение , значения, содержащиеся в oldValues коллекции, форматируются вместе со свойством OldValuesParameterFormatString и также объединяются.
Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед обновлением. Для выполнения операции обновления использует отражение для вызова метода, ObjectDataSourceView определяемого свойством UpdateMethod и любыми связанными параметрами keys в коллекции, а затем выполняет его. После завершения операции вызывается метод для OnUpdated вызова Updated события . Это событие можно обработать для проверки возвращаемых значений, кодов ошибок и выполнения постобработки.
Дополнительные сведения о возврате количества обновленных строк см. в разделе Update.
