Método Update

Artigo
05/30/2023

Salva as alterações feitas na linha atual de um objeto Recordset ou na coleção Fields de um objeto Record.

Sintaxe

  
recordset.Update Fields, Values  
record.Fields.Update

Parâmetros

Fields
Opcional. Uma Variant que representa um só nome ou uma matriz Variant que representa nomes ou posições ordinais dos campos que você deseja modificar.

Valores
Opcional. Uma Variant que representa um só valor ou uma matriz Variant que representa valores para os campos no novo registro.

Comentários

Conjunto de registros

Use o método Update para salvar as alterações feitas no registro atual de um objeto Recordset, desde a chamada ao método AddNew ou desde a alteração dos valores de campo em um registro existente. O objeto Recordset precisa dar suporte a atualizações.

Para definir valores de campo, siga um destes procedimentos:

Atribua valores à propriedade Value de um objeto Field e chame o método Update.
Transmita um nome de campo e um valor como argumentos com a chamada Update.
Transmita uma matriz de nomes de campos e uma matriz de valores com a chamada Update.

Quando você usa matrizes de campos e valores, é preciso haver um número igual de elementos em ambas as matrizes. Além disso, a ordem dos nomes dos campos precisa corresponder à ordem dos valores dos campos. Se o número e a ordem dos campos e dos valores não corresponderem, ocorrerá um erro.

Se o objeto Recordset der suporte à atualização em lote, você poderá armazenar em cache várias alterações em um ou mais registros localmente até chamar o método UpdateBatch. Se você estiver editando o registro atual ou adicionando um novo registro quando chamar o método UpdateBatch, o ADO chamará automaticamente o método Update para salvar as alterações pendentes no registro atual antes de transmitir as alterações em lote para o provedor.

Se você mover do registro que está adicionando ou editando antes de chamar o método Update, o ADO chamará automaticamente Update para salvar as alterações. Você precisa chamar o método CancelUpdate se quiser cancelar as alterações feitas no registro atual ou descartar um registro recém-adicionado.

O registro atual permanece atual depois que você chama o método Update.

Record

O método Update finaliza adições, exclusões e atualizações em campos na coleção Fields de um objeto Record.

Por exemplo, os campos excluídos com o método Delete são marcados para exclusão imediatamente, mas permanecem na coleção. O método Update precisa ser chamado para realmente excluir esses campos da coleção do provedor.