ObjectDataSourceView.ExecuteDelete(IDictionary, IDictionary) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Performs a delete operation using the DeleteMethod method and the specified keys
and oldValues
collection.
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
Parameters
- keys
- IDictionary
A IDictionary of parameters used with the DeleteMethod property to perform the delete operation. If there are no parameters associated with the method, pass null
.
- oldValues
- IDictionary
A IDictionary that contains row values that are evaluated, only if the ConflictDetection property is set to the CompareAllValues field.
Returns
The number of rows deleted; otherwise, -1, if the number is not known. For more information, see Delete.
Exceptions
The CanDelete property returns false
.
The ConflictDetection property is set to the CompareAllValues value, and no values are passed in the oldValues
collection.
Remarks
The ObjectDataSourceView class implements the inherited ExecuteDelete method to delete data from an underlying data store using a business object. Page developers and data-bound control authors do not call the ExecuteDelete method directly; instead, use the publicly exposed Delete method.
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 perform any preprocessing before the Delete method is called.
To perform a delete operation, the ObjectDataSourceView uses reflection to call the method that is identified by the DeleteMethod property and any associated parameters in the keys
and oldValues
collections, and then executes it. After the 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.