SqlDataSourceView.ExecuteDelete(IDictionary, IDictionary) Метод

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Выполняет операцию удаления, используя 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 -> int

Protected Overrides Function ExecuteDelete (keys As IDictionary, oldValues As IDictionary) As Integer

Параметры

keys

IDictionary

Объект IDictionary или значения ключей строки, которые должны быть удалены с помощью операции ExecuteDelete(IDictionary, IDictionary).

oldValues

IDictionary

Объект IDictionary, содержащий значения строки, которые вычисляются, только если для свойства ConflictDetection задано значение CompareAllValues.

Возвращаемое значение

Int32

Значение, представляющее число строк, удаленных из основной базы данных.

Исключения

InvalidOperationException

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.

-или-

Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.

HttpException

У текущего пользователя нет надлежащих прав для доступа к базе данных.

-или-

Экземпляром элемента управления является элемент управления AccessDataSource, а к месту, к которому ведет путь, заданный для свойства DataFile, запрещен доступ.

NotSupportedException

Значение свойства CanDelete — false.

-или-

Относительный путь времени разработки не правильно сопоставлен конструктором перед использованием экземпляра элемента управления AccessDataSource.

Комментарии

Класс SqlDataSourceView реализует наследуемый ExecuteDelete метод для удаления данных из базы данных. Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteDelete метод напрямую, а используют открытый Delete метод.

Значения, содержащиеся в коллекции, вычисляются и объединяются со значениями, содержащимися в keysDeleteParameters коллекции. Если свойству ConflictDetection присвоено CompareAllValues значение , значения, содержащиеся в oldValues коллекции, форматируются вместе со свойством OldValuesParameterFormatString и также объединяются.

Перед выполнением OnDeleting операции удаления вызывается метод для вызова Deleting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед удалением.

Чтобы выполнить операцию удаления, SqlDataSourceView объект создает DbCommand объект с использованием DeleteCommand текста и всех связанных DeleteParameters свойств, а затем выполняет DbCommand объект в базовой базе данных. После завершения операции удаления вызывается метод для OnDeleted вызова Deleted события . Это событие можно обработать для проверки возвращаемых значений и кодов ошибок, а также для выполнения постобработки.

См. также раздел

• Delete(IDictionary, IDictionary)
• DeleteCommand
• DeleteParameters