Método CancelBatch (ADO)

Aplica-se ao: Access 2013, Office 2013

Cancela uma atualização em lotes pendente.

Sintaxe

conjunto de registros. CancelBatch AffectRecords

Parâmetros

Parâmetro	Descrição
AffectRecords	Opcional. Um valor AffectEnum que determina a quantidade de registros que serão afetados pelo método CancelBatch.

Comentários

Use o método CancelBatch para cancelar todas as atualizações pendentes em um Recordset no modo de atualização em lotes. Se Recordset estiver no modo de atualização imediata, um erro será gerado se CancelBatch for chamado sem adAffectCurrent.

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

É possível que o registro atual não possa ser determinado após uma chamada de CancelBatch, principalmente se você estiver no processo de adição de um novo registro. Por esse motivo, convém definir a posição do registro atual para 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, por causa da exclusão de um registro por outro usuário), o provedor retornará avisos à coleção Errors, mas não interromperá a execução do programa. Um erro em tempo de execução somente ocorrerá em caso de conflito em todos os registros solicitados. Use a propriedade Filter (adFilterConflictingRecords) e a propriedade Status para localizar registros com conflitos.