Método CancelUpdate (ADO)

Aplica-se ao: Access 2013, Office 2013

Cancela qualquer alteração feita na linha atual ou na nova linha de um objeto Recordset, ou na coleção Fields de um objeto Record, antes da chamada do método Update.

Sintaxe

conjunto de registros. CancelUpdate

registro. Campos. CancelUpdate

Comentários

Recordset

Use o método CancelUpdate para cancelar as alterações feitas na linha atual ou descartar uma linha recém-adicionada. Você não poderá cancelar as alterações feitas na linha atual ou em uma nova linha após chamar o método Update, a menos que as alterações façam parte de uma transação que possa ser revertida com o método RollbackTrans ou façam parte de uma atualização em lotes. No caso de uma atualização em lotes, você poderá cancelar Update com o método CancelUpdate ou CancelBatch.

Se, ao chamar o método CancelUpdate, você estiver adicionando uma nova linha, a linha atual passará a ser a linha que estava atual antes da chamada de AddNew.

Se estiver no modo de edição e desejar sair do registro atual (por exemplo, com Move, NextRecordset ou Close), você poderá usar CancelUpdate para cancelar as alterações pendentes. Esse procedimento será necessário se a atualização não puder ser postada com êxito na fontes de dados (por exemplo, a falha de uma tentativa de exclusão devido a violações de integridade referencial manterá o Recordset no modo de edição depois que Delete for chamado).

Objeto Record

O método CancelUpdate cancela qualquer inserção ou exclusão pendente de objetos Field, e também cancela as atualizações pendentes de campos existentes, restaurando-os aos seus valores originais. A propriedade Status de todos os campos na coleção Fields é definida como adFieldOK.