SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет операцию удаления с помощью DeleteCommand строки SQL, всех параметров, указанных в 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 -> int
Protected 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 метод.
Значения, содержащиеся в keys коллекции, вычисляются и объединяются с любыми значениями, содержащимися в DeleteParameters коллекции.
ConflictDetection Если свойству присвоено CompareAllValues значение, значения, содержащиеся в oldValues коллекции, форматируются с OldValuesParameterFormatString помощью свойства, а также объединяются.
Перед выполнением OnDeleting операции удаления вызывается метод для вызова Deleting события. Это событие можно обрабатывать для проверки значений параметров и выполнения предварительной обработки перед удалением.
Для выполнения операции SqlDataSourceView удаления объект создает DbCommand объект с помощью DeleteCommand текста и всех связанных DeleteParameters свойств, а затем выполняет DbCommand объект в базовой базе данных. После завершения OnDeleted операции удаления вызывается метод для вызова Deleted события. Это событие можно обрабатывать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.