Método CancelBatch (ADO)

Cancela uma atualização em lote pendente.

Sintaxe

  
recordset.CancelBatchAffectRecords  

Parâmetros

AffectRecords
Opcional. Um valor AffectEnum que indica quantos registros o método CancelBatch afetará.

Comentários

Use o método CancelBatch para cancelar todas as atualizações pendentes em um Recordset no modo de atualização em lote. Se o Recordset estiver no modo de atualização imediata, a chamada de CancelBatch sem adAffectCurrent irá gerar um erro.

Se você estiver editando o registro atual ou adicionando um novo registro quando chamar CancelBatch, o ADO chamará primeiro o método CancelUpdate para cancelar as alterações armazenadas em cache. Depois disso, todas as alterações pendentes em Recordset serão canceladas.

O registro atual pode ser indeterminado após uma chamada de CancelBatch, especialmente se você estiver no processo de adição de um novo registro. Por esse motivo, é recomendável definir a posição do registro atual como um local conhecido no Recordset após a chamada de CancelBatch. Por exemplo, chame o método MoveFirst.

Se a tentativa de cancelar as atualizações pendentes falhar devido a um conflito com os dados subjacentes (por exemplo, se um registro tiver sido excluído por outro usuário), o provedor retornará avisos para a coleção Errors, mas não interromperá a execução do programa. Um erro em tempo de execução só ocorre se houver conflitos em todos os registros solicitados. Use a propriedade Filter (adFilterAffectedRecords) e a propriedade Status para localizar registros com conflitos.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo dos métodos UpdateBatch CancelBatch (VB)
Exemplo dos métodos UpdateBatch CancelBatch (VC++)
Método Cancel (ADO)
Método Cancel (RDS)
Método CancelUpdate (ADO)
Método CancelUpdate (RDS)
Método Clear (ADO)
Propriedade LockType (ADO)
Método UpdateBatch