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á.

Observações

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

Se você estiver editando o registro atual ou estiver 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 no conjunto de registros são canceladas.

O registro atual pode ser indeterminado após uma chamada CancelBatch, especialmente se você estiver no processo de adicionar um novo registro. Por esse motivo, é prudente definir a posição atual do registro para um local conhecido no Recordset após a chamada 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 o Erros coleção, mas não interromperá a execução do programa. Um erro em tempo de execução ocorrerá somente 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

do objeto Recordset (ADO)

Consulte Também

Exemplo dos métodos UpdateBatch e CancelBatch (VB)
Exemplo dos métodos UpdateBatch e CancelBatch (VC++)
do método Cancel (ADO)
do Método de Cancelamento de (RDS)
método CancelUpdate (ADO)
método CancelUpdate (RDS)
método Clear (ADO)
propriedade LockType (ADO)
método UpdateBatch