ADO: ActiveX Data Objects

Name

Recordset.Delete Method — (Versions 2.0, 2.1, 2.5, 2.6)

Synopsis

                     recordset.Delete AffectRecords
                  

The Delete method deletes specified records within the recordset.

Arguments

AffectRecords (Affect Enum)

Optional. Indicates either the value of adAffectCurrent or adAffectGroup.

If the value of AffectRecords is adAffectCurrent, the CancelBatch method call affects only the pending updates for the current record of the recordset.

If the value of AffectRecords is adAffectGroup, the CancelBatch method call affects only the pending records that are dictated through the Filter property of the current Recordset object. This property must be already set for the CancelBatch method to be called with the adAffectGroup parameter.

Description

The Delete method removes a record or a group of records when used with the Recordset object. The Delete method removes a specified Parameter object from the Parameters collection when used with it.

When using the Delete method with the Recordset object, records that are to be deleted are actually marked for deletion. If the particular recordset does not allow deletion, an error occurs. In immediate update mode, the deletion occurs immediately. However, in batch update mode, the records are marked deleted and are cached until the UpdateBatch method is called. You can view the deleted records by using the Filter property.

After you delete a record, the current record position is still on that record. Once you move from that record position, the records are no longer ...