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

Определение

Выполняет операцию удаления, используя SQL-строку DeleteCommand, все параметры, заданные в коллекции DeleteParameters, и значения, содержащиеся в заданных коллекциях keys и oldValues.Performs a delete operation using the DeleteCommand SQL string, any parameters that are specified in the DeleteParameters collection, and the values that are in the specified keys and oldValues collections.

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).An IDictionary of object or row key values for the ExecuteDelete(IDictionary, IDictionary) operation to delete.

oldValues
IDictionary

Объект IDictionary, содержащий значения строки, которые вычисляются, только если для свойства ConflictDetection задано значение CompareAllValues.An IDictionary that contains row values that are evaluated only if the ConflictDetection property is set to the CompareAllValues value.

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

Значение, представляющее число строк, удаленных из основной базы данных.A value that represents the number of rows deleted from the underlying database.

Исключения

Объекту SqlDataSource не удается установить подключение к базовому источнику данных.The SqlDataSource cannot establish a connection with the underlying data source.

- или --or- Свойству ConflictDetection присвоено значение CompareAllValues без передачи параметра oldValues.The ConflictDetection property is set to the CompareAllValues value and no oldValues parameters are passed.

У текущего пользователя нет надлежащих прав для доступа к базе данных.The current user does not have the correct permissions to access to the database.

- или --or- Экземпляром элемента управления является элемент управления AccessDataSource, а к месту, к которому ведет путь, заданный для свойства DataFile, запрещен доступ.The instance of the control is an AccessDataSource control and access is denied to the path specified for the DataFile property.

Значение свойства CanDeletefalse.The CanDelete property is false.

- или --or- Относительный путь времени разработки не правильно сопоставлен конструктором перед использованием экземпляра элемента управления AccessDataSource.A design-time relative path was not mapped correctly by the designer before using an instance of the AccessDataSource control.

Комментарии

Класс реализует наследуемый ExecuteDelete метод для удаления данных из базы данных. SqlDataSourceViewThe SqlDataSourceView class implements the inherited ExecuteDelete method to delete data from a database. Разработчики страниц и элементы управления с привязкой к данным не вызывают ExecuteDelete метод напрямую; вместо этого используйте Delete общедоступный метод.Page developers and data-bound control authors do not call the ExecuteDelete method directly; instead, use the publicly exposed Delete method.

Значения, содержащиеся в keys коллекции, оцениваются и объединяются с любыми значениями, содержащимися DeleteParameters в коллекции.The values that are contained in the keys collection are evaluated and merged with any values that are contained by the DeleteParameters collection. Если свойству присвоено CompareAllValues значение, значения oldValues , содержащиеся в коллекции, форматируются с помощью OldValuesParameterFormatString свойства и также объединяются. ConflictDetectionIf the ConflictDetection property is set to the CompareAllValues value, the values that are contained in the oldValues collection are formatted with the OldValuesParameterFormatString property and are also merged.

Перед выполнением операции OnDeleting удаления вызывается метод для Deleting вызова события.Before the delete operation is performed, the OnDeleting method is called to raise the Deleting event. Это событие можно обработать для проверки значений параметров и выполнения предварительной обработки перед удалением.You can handle this event to examine the values of the parameters and to perform any preprocessing before a delete.

Для выполнения SqlDataSourceView операции удаления объект DeleteCommand DbCommand создает объект, используя текст и все DbCommand связанные DeleteParameters свойства, а затем выполняет объект для базовой базы данных.To perform a delete operation, the SqlDataSourceView object builds a DbCommand object using the DeleteCommand text and any associated DeleteParameters properties, and then executes the DbCommand object against the underlying database. После завершения OnDeleted операции удаления вызывается метод для Deleted вызова события.After the delete operation completes, the OnDeleted method is called to raise the Deleted event. Это событие можно обработать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.You can handle this event to examine any return values and error codes and to perform any post-processing.

Применяется к

Дополнительно