Método Delete (Conjunto de Registros do ADO)

Exclui o registro atual ou um grupo de registros.

Sintaxe

  
recordset.Delete AffectRecords  

Parâmetros

AffectRecords
Um valor AffectEnum que determina quantos registros o método Delete afetará. O valor padrão é adAffectCurrent.

Nota

adAffectAll e adAffectAllChapters não são argumentos válidos para Excluir.

Observações

Usar o método Delete marca o registro atual ou um grupo de registros em um recordset objeto para exclusão. Se o Recordset objeto não permitir a exclusão de registro, ocorrerá um erro. Se você estiver no modo de atualização imediata, as exclusões ocorrerão no banco de dados imediatamente. Se um registro não puder ser excluído com êxito (devido a violações de integridade do banco de dados, por exemplo), o registro permanecerá no modo de edição após a chamada para Atualização. Isso significa que você deve cancelar a atualização com CancelUpdate antes de sair do registro atual (por exemplo, com Fechar, Moverou NextRecordset).

Se você estiver no modo de atualização em lote, os registros serão marcados para exclusão do cache e a exclusão real ocorrerá quando você chamar o método UpdateBatch. Use a propriedade Filter para exibir os registros excluídos.

Recuperar valores de campo do registro excluído gera um erro. Depois de excluir o registro atual, o registro excluído permanecerá atual até que você mude para um registro diferente. Depois que você se afastar do registro excluído, ele não estará mais acessível.

Se você aninhar exclusões em uma transação, poderá recuperar registros excluídos com o método RollbackTrans. Se você estiver no modo de atualização em lote, poderá cancelar uma exclusão pendente ou um grupo de exclusões pendentes com o método CancelBatch.

Se a tentativa de excluir registros falhar devido a um conflito com os dados subjacentes (por exemplo, um registro já foi excluído por outro usuário), o provedor retornará avisos para o Erros coleção, mas não interromperá a execução do programa. Um erro em tempo de execução ocorrerá somente se houver conflitos em todos os registros solicitados.

Se a propriedade dinâmica Unique Table estiver definida e o Recordset for o resultado da execução de uma operação JOIN em várias tabelas, o método Delete excluirá apenas linhas da tabela nomeada na propriedade tabela exclusiva.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

de exemplo do método Delete (VB)
exemplo do método Delete (VBScript)
Exemplo do método Delete (VC++)
Método Delete (coleção ADO Fields)
Método Delete (Coleção de Parâmetros do ADO)
método DeleteRecord (ADO)