Método Update

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

Sintaxe

  
recordset.Update Fields, Values  
record.Fields.Update  

Parâmetros

campos
Opcional. Um Variant que representa um único nome ou uma matriz de variant que representa nomes ou posições ordinais do campo ou campos que você deseja modificar.

valores
Opcional. Um Variant que representa um único valor ou uma matriz variant que representa valores para o campo ou campos no novo registro.

Observações

Conjunto de registros

Use o método Update para salvar as alterações feitas no registro atual de um objeto Recordset desde que você chama o método AddNew ou desde que alterou os valores de campo em um registro existente. O objeto Recordset deve dar suporte a atualizações.

Para definir valores de campo, siga um destes procedimentos:

• Atribua valores à propriedade de valor de um objeto de campo de e chame o método de Atualização de.

• Passe um nome de campo e um valor como argumentos com a chamada Atualizar.

• Passe uma matriz de nomes de campo e uma matriz de valores com a chamada Atualizar.

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

Se o Recordset objeto oferecer 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 ao 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ê deve 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.

Registro

O método Update finaliza adições, exclusões e atualizações para campos na coleção Campos de um objeto de Registro.

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 deve ser chamado para realmente excluir esses campos da coleção do provedor.

Aplica-se a

da Coleção Fields (ADO)

do objeto Recordset (ADO)

Consulte Também

Exemplo dos métodos Update e CancelUpdate (VB)
Exemplo dos métodos Update e CancelUpdate (VC++)
método AddNew (ADO)
método CancelUpdate (ADO)
de propriedade EditMode
método UpdateBatch