ObjectDataSourceView.ExecuteUpdate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию обновления путем вызова метода, определяемого свойствомUpdateMethod, и используя все параметры, предоставленные в keysколлекциях или valuesoldValues коллекциях.
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 метод.
Значения, содержащиеся в keys коллекциях, values вычисляются и объединяются с любыми значениями, содержащимися в UpdateParameters коллекции.
ConflictDetection Если свойству присвоено CompareAllValues значение, значения, содержащиеся в oldValues коллекции, форматируются с OldValuesParameterFormatString помощью свойства, а также объединяются.
Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события. Это событие можно обрабатывать для проверки значений параметров и выполнения предварительной обработки перед обновлением. Для выполнения операции обновления использует отражение для вызова метода, ObjectDataSourceView который определяется UpdateMethod свойством и любыми связанными параметрами в keys коллекции, а затем выполняет его. После завершения OnUpdated операции вызывается метод для вызова Updated события. Это событие можно обрабатывать для проверки любых возвращаемых значений, кодов ошибок и выполнения любой последующей обработки.
Дополнительные сведения о возврате количества обновленных строк см. в разделе Update.
