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