SqlDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию обновления с помощью UpdateCommand строки SQL, всех параметров, входящих в UpdateParameters коллекцию, и значений, содержащихся в указанных keysvaluesколлекциях, и 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 ключи, используемые с свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом нет ключей или если UpdateCommand свойство не является параметризованным SQL-запросом, передайте null.
- values
- IDictionary
Значение IDictionary , используемое с свойством UpdateCommand для выполнения операции обновления базы данных. Если с запросом нет параметров или если UpdateCommand параметризованный SQL-запрос не связан, передайте null.
- oldValues
- IDictionary
Объект, IDictionary представляющий исходные значения в базе данных. Если нет параметров, связанных с запросом, или если UpdateCommand свойство не является параметризованным SQL-запросом, передайте null.
Возвращаемое значение
Значение, представляющее количество строк, обновленных в базовой базе данных.
Исключения
Невозможно SqlDataSource установить подключение к базовому источнику данных.
–или–
Для ConflictDetection свойства задано CompareAllValues значение, и параметры не oldValues передаются.
Текущий пользователь не имеет правильных разрешений для получения доступа к базе данных.
Свойство CanUpdate является false.
Комментарии
Класс SqlDataSourceView реализует унаследованный ExecuteUpdate метод для обновления данных в базе данных. Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteUpdate метод напрямую. Вместо этого используйте общедоступный Update метод.
Значения, содержащиеся в keys коллекциях, values оцениваются и объединяются с любыми значениями, содержащимися в UpdateParameters коллекции.
ConflictDetection Если для свойства задано CompareAllValuesзначение, значения, содержащиеся в oldValues коллекции, форматируются и OldValuesParameterFormatString объединяются.
Перед выполнением OnUpdating операции обновления вызывается метод для вызова Updating события. Это событие можно обрабатывать для проверки значений параметров и выполнения предварительной обработки перед обновлением.
Чтобы выполнить операцию, SqlDataSourceView объект создает DbCommand объект с помощью UpdateCommand текста и всех связанных UpdateParameters свойств, а затем выполняет DbCommand объект в базовой базе данных. После завершения OnUpdated операции вызывается метод для вызова Updated события. Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.
