Método CancelUpdate (ADO)

Cancela as alterações feitas na linha atual ou nova de um objeto recordset ou na coleção campos de de um objeto de registro, antes de chamar o método de Atualização.

Sintaxe

  
recordset.CancelUpdaterecord.Fields.CancelUpdate  

Observações

Conjunto de registros

Use o método CancelUpdate para cancelar as alterações feitas na linha atual ou descartar uma linha recém-adicionada. Não é possível cancelar alterações na linha atual ou em uma nova linha depois de chamar o método Update, a menos que as alterações sejam parte de uma transação que você possa reverter com o método RollbackTrans ou parte de uma atualização em lote. No caso de uma atualização em lote, você pode cancelar o Update com o método CancelUpdate ou CancelBatch.

Se você estiver adicionando uma nova linha ao chamar o método CancelUpdate, a linha atual se tornará a linha atual antes da chamada AddNew.

Se você estiver no modo de edição e quiser sair do registro atual (por exemplo, usando os métodos Move, NextRecordsetou Close), poderá usar CancelUpdate para cancelar as alterações pendentes. Talvez seja necessário fazer isso se a atualização não puder ser postada com êxito na fonte de dados. Por exemplo, uma tentativa de exclusão que falha devido a violações de integridade referencial deixará o conjunto de registros no modo de edição após uma chamada para Excluir.

Registro

O método CancelUpdate cancela quaisquer inserções ou exclusões pendentes de objetos de campo e cancela atualizações pendentes de campos existentes e as restaura para seus valores originais. A propriedade Status de todos os campos da coleção Fields está definida como adFieldOK.

Aplica-se a

da Coleção Fields (ADO)

do objeto Recordset (ADO)

Consulte Também

Exemplo dos métodos Update e CancelUpdate (VB)
Exemplo dos métodos Update e CancelUpdate (VC++)
método AddNew (ADO)
do método Cancel (ADO)
do Método de Cancelamento de (RDS)
método CancelBatch (ADO)
método CancelUpdate (RDS)
de propriedade EditMode
método Update