Método UpdateBatch (ADO)
Aplica-se ao: Access 2013, Office 2013
Grava todas as atualizações em lote pendentes no disco.
Sintaxe
conjunto de registros. UpdateBatchAffectRecords
Parâmetros
| Parâmetro | Descrição |
|---|---|
| AffectRecords | Opcional. Um valor AffectEnum que indica quantos registros o método UpdateBatch afetará. |
Comentários
Utilize o método UpdateBatch ao modificar um objeto Recordset no modo de atualização em lote a fim de transmitir todas as alterações feitas em um objeto Recordset para o banco de dados base.
Se o objeto Recordset suportar atualização em lote, você poderá armazenar localmente em cache diversas alterações em um ou mais registros até chamar o método UpdateBatch. Se estiver editando o registro atual ou adicionando um novo registro ao chamar o método UpdateBatch, o ADO chamará automaticamente o método Update para salvar quaisquer informações pendentes no registro atual antes de transmitir as alterações em lote ao provedor. Você deve utilizar a atualização em lote apenas com um conjunto de chaves ou um cursor estático.
Observação
[!OBSERVAçãO] A especificação de adAffectGroup como o valor para esse parâmetro resultará em um erro quando não existirem registros visíveis no Recordset atual (tal como um filtro ao qual nenhum registro corresponde).
Se a tentativa de transmitir alterações falhar para algum ou todos os registros devido a um conflito com os dados base (por exemplo, um registro já foi excluído por outro usuário), o provedor retornará avisos para a coleção Errors e ocorrerá um erro em tempo de execução. Utilize a propriedade Filter (adFilterAffectedRecords) e a propriedade Status para localizar registros com conflitos.
Para cancelar todas as atualizações em lote pendentes, utilize o método CancelBatch.
Se as propriedades dinâmicas Unique Table e Update Resyncforem definidas e o Recordset for o resultado da execução de uma operação JOIN em várias tabelas, então a execução do método UpdateBatch será implicitamente seguida pelo método Resync, dependendo das definições da propriedade Update Resync.
A ordem na qual as atualizações individuais de um lote são executadas na fonte de dados não é necessariamente a mesma que a ordem na qual elas foram executadas no Recordset local. A ordem da atualização depende do provedor. Leve isso em consideração ao codificar atualizações que estão relacionadas entre si, tais como restrições de chave estrangeira ou uma inserção ou atualização.