SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию удаления, используя SQL-строку DeleteCommand, все параметры, заданные в коллекции DeleteParameters, и значения, содержащиеся в заданных коллекциях keys и oldValues.
protected:
override int ExecuteDelete(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ oldValues);protected override int ExecuteDelete (System.Collections.IDictionary keys, System.Collections.IDictionary oldValues);override this.ExecuteDelete : System.Collections.IDictionary * System.Collections.IDictionary -> intProtected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As IntegerПараметры
- keys
- IDictionary
Объект IDictionary или значения ключей строки, которые должны быть удалены с помощью операции ExecuteDelete(IDictionary, IDictionary).
- oldValues
- IDictionary
Объект IDictionary, содержащий значения строки, которые вычисляются, только если для свойства ConflictDetection задано значение CompareAllValues.
Возвращаемое значение
Значение, представляющее число строк, удаленных из основной базы данных.
Исключения
Объекту SqlDataSource не удается установить подключение к базовому источнику данных.
-или-
Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.
У текущего пользователя нет надлежащих прав для доступа к базе данных.
-или-
Экземпляром элемента управления является элемент управления AccessDataSource, а к месту, к которому ведет путь, заданный для свойства DataFile, запрещен доступ.
Значение свойства CanDelete — false.
-или-
Относительный путь времени разработки не правильно сопоставлен конструктором перед использованием экземпляра элемента управления AccessDataSource.
Комментарии
Класс SqlDataSourceView реализует наследуемый ExecuteDelete метод для удаления данных из базы данных. Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteDelete метод напрямую, а используют открытый Delete метод.
Значения, содержащиеся в коллекции, вычисляются и объединяются со значениями, содержащимися в keysDeleteParameters коллекции. Если свойству ConflictDetection присвоено CompareAllValues значение , значения, содержащиеся в oldValues коллекции, форматируются вместе со свойством OldValuesParameterFormatString и также объединяются.
Перед выполнением OnDeleting операции удаления вызывается метод для вызова Deleting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед удалением.
Чтобы выполнить операцию удаления, SqlDataSourceView объект создает DbCommand объект с использованием DeleteCommand текста и всех связанных DeleteParameters свойств, а затем выполняет DbCommand объект в базовой базе данных. После завершения операции удаления вызывается метод для OnDeleted вызова Deleted события . Это событие можно обработать для проверки возвращаемых значений и кодов ошибок, а также для выполнения постобработки.
