Método CancelUpdate (ADO)

Cancela as alterações feitas na linha atual ou nova de um objeto Recordset ou na coleção Fields de um objeto Record, antes de chamar o método Update.

Sintaxe

  
recordset.CancelUpdaterecord.Fields.CancelUpdate  

Comentários

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 as alterações na linha atual ou em uma nova linha depois de chamar o método Update, a menos que as alterações façam parte de uma transação que você possa reverter com o método RollbackTrans ou façam parte de uma atualização em lote. No caso de uma atualização em lote, você pode cancelar 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 a AddNew.

Se você estiver no modo de edição e quiser sair do registro atual (por exemplo, usando os métodos Move, NextRecordset ou 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 Recordset no modo de edição após uma chamada para Delete.

Record

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

Aplica-se A

Coleção Fields (ADO)

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)
Método Cancel (ADO)
Método Cancel (RDS)
Método CancelBatch (ADO)
Método CancelUpdate (RDS)
Propriedade EditMode
Método Update