Delete Method (ADO Recordset)

Microsoft ActiveX Data Objects (ADO)

ADO 2.5 API Reference

Delete Method (ADO Recordset)

Deletes the current record or a group of records.

Syntax

recordset.Delete AffectRecords

Parameters

AffectRecords
An AffectEnum value that determines how many records the Delete method will affect. The default value is adAffectCurrent.
Note   adAffectAll and adAffectAllChapters are not valid arguments to Delete.

Remarks

Using the Delete method marks the current record or a group of records in a Recordset object for deletion. If the Recordset object doesn't allow record deletion, an error occurs. If you are in immediate update mode, deletions occur in the database immediately. If a record cannot be successfully deleted (due to database integrity violations, for example), the record will remain in edit mode after the call to Update. This means that you must cancel the update with CancelUpdate before moving off the current record (for example, with Close, Move, or NextRecordset).

If you are in batch update mode, the records are marked for deletion from the cache and the actual deletion happens when you call the UpdateBatch method. (Use the Filter property to view the deleted records.)

Retrieving field values from the deleted record generates an error. After deleting the current record, the deleted record remains current until you move to a different record. Once you move away from the deleted record, it is no longer accessible.

If you nest deletions in a transaction, you can recover deleted records with the RollbackTrans method. If you are in batch update mode, you can cancel a pending deletion or group of pending deletions with the CancelBatch method.

If the attempt to delete records fails because of a conflict with the underlying data (for example, a record has already been deleted by another user), the provider returns warnings to the Errors collection but does not halt program execution. A run-time error occurs only if there are conflicts on all the requested records.

If the Unique Table dynamic property is set, and the Recordset is the result of executing a JOIN operation on multiple tables, then the Delete method will only delete rows from the table named in the Unique Table property.

See Also

Visual Basic Example | VBScript Example | Visual C++ Example | Visual J++ Example

Delete Method (ADO Fields Collection) | Delete Method (ADO Parameters Collection) | DeleteRecord Method

Applies To: Recordset Object

© 1998-2003 Microsoft Corporation. All rights reserved.