Delete (método) (conjunto de registros ADO)

Elimina el registro actual o un grupo de registros.

Sintaxis

  
recordset.Delete AffectRecords  

Parámetros

AffectRecords
Valor de AffectEnum que determina cuántos registros afectará el método Delete. El valor predeterminado es adAffectCurrent.

Nota

adAffectAll y adAffectAllChapters no son argumentos válidos para Delete.

Comentarios

El uso del método Delete marca el registro actual o un grupo de registros en un objeto Recordset para su eliminación. Si el objeto Recordset no permite la eliminación de registros, se produce un error. Si está en modo de actualización inmediata, las eliminaciones se producen inmediatamente en la base de datos. Si un registro no se puede eliminar correctamente (debido a infracciones de integridad de la base de datos, por ejemplo), el registro permanecerá en modo de edición después de la llamada a Update. Esto significa que debe cancelar la actualización con CancelUpdate antes de desactivar el registro actual (por ejemplo, con Close, Move o NextRecordset).

Si está en modo de actualización por lotes, los registros se marcan para su eliminación de la memoria caché y la eliminación real se produce cuando se llama al método UpdateBatch. Utilice la propiedad Filter para ver los registros eliminados.

La recuperación de valores de campo del registro eliminado genera un error. Después de eliminar el registro actual, el registro eliminado permanece activo hasta que se mueve a otro registro. Una vez que se aleja del registro eliminado, ya no es accesible.

Si anida eliminaciones en una transacción, puede recuperar los registros eliminados con el método RollbackTrans. Si está en modo de actualización por lotes, puede cancelar una eliminación pendiente o un grupo de eliminaciones pendientes con el método CancelBatch.

Si se produce un error en el intento de eliminar registros debido a un conflicto con los datos subyacentes (por ejemplo, otro usuario ya ha eliminado un registro), el proveedor devuelve advertencias a la colección Errors, pero no detiene la ejecución del programa. Un error en tiempo de ejecución solo se produce si hay conflictos en todos los registros solicitados.

Si se establece la propiedad dinámica Unique Table y Recordset es el resultado de ejecutar una operación JOIN en varias tablas, el método Delete solo eliminará las filas de la tabla denominada en la propiedad Unique Table.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Eliminar el ejemplo del método (VB)
Ejemplo del método Delete (VBScript)
Ejemplo del método Delete (VC ++)
El método Delete (colección Fields de ADO)
Método Delete (colección de parámetros de ADO)
DeleteRecord (método, ADO)