Método Recordset2.Update (DAO)
Aplica-se ao: Access 2013, Office 2013
Sintaxe
expressão . Update(UpdateType, Force)
Expressão Uma variável que representa um objeto Recordset2 .
Parâmetros
Nome |
Necessária/opcional |
Tipo de dados |
Descrição |
|---|---|---|---|
UpdateType |
Opcional |
Long |
Uma constante UpdateTypeEnum indicando o tipo de atualização, como especificado em Configurações (somente espaços de trabalho ODBCDirect). |
Força |
Opcional |
Boolean |
Um valor Boolean indicando se é preciso impor ou não as alterações ao banco de dados, independentemente de os dados subjacentes terem sido alterados por outro usuário desde a chamada AddNew, Delete ou Edit. Se for True, as alterações serão impostas e as alterações feitas por outros usuários serão simplesmente substituídas. Se for False (padrão), as alterações feitas por outro usuário enquanto a atualização estiver pendente causarão uma falha na atualização para as alterações que estiverem em conflito. Nenhum erro ocorre, mas as propriedades BatchCollisionCount e BatchCollisions indicarão o número de conflitos e as linhas afetadas por conflitos, respectivamente (somente workspaces ODBCDirect). |
Comentários
Use Update para salvar o registro atual e todas as alterações feitas nele.
Importante
As alterações do registro atual serão perdidas se:
- Você utilizar os métodos Edit ou AddNew e mover para outro registro sem primeiro usar Update.
- Você utilizar Edit ou AddNew e, em seguida, usar Edit ou AddNew novamente sem primeiro usar Update.
- Você definir a propriedade Bookmark para outro registro.
- Você fechar o Recordset sem usar primeiro Update.
- Você cancelar a operação Edit utilizando CancelUpdate.
Para editar um registro, use o método Edit para copiar o conteúdo do registro atual para um buffer de cópia. Se você não usar Edit primeiro, ocorrerá um erro ao usar Update ou tentar alterar um valor de campo.
Em um espaço de trabalho ODBCDirect, você pode fazer atualizações em lote, desde que a biblioteca de cursores aceite atualizações em lote, e o Recordset tenha sido aberto com a opção de bloqueio de lote otimista.
Em um espaço de trabalho do Microsoft Access, quando a configuração da propriedade LockEdits do objeto Recordset é True (bloqueado de forma pessimista) em um ambiente de vários usuários, o registro permanece bloqueado desde o momento em que Edit é usado até que o método Update seja executado ou a edição seja cancelada. Se a configuração da propriedade LockEdits é False (bloqueado de forma otimista), o registro é bloqueado e comparado ao registro pré-editado antes de ser atualizado no banco de dados. Se o registro foi alterado desde o uso do método Edit, a operação Update falhará. Os bancos de dados ODBC e ISAM instalável conectados ao mecanismo de banco de dados do Microsoft Access sempre utilizam bloqueio otimista. Para continuar a operação Update com suas alterações, use o método Update novamente. Para reverter para o registro de acordo com o que outro usuário tenha alterado, atualize o registro atual usando Mover 0.
Observação
[!OBSERVAçãO] Para adicionar, editar ou excluir um registro, deve haver um índice exclusivo no registro, na fonte de dados de base. Se não houver, um erro "Permissão negada" ocorrerá na chamada do método AddNew, Delete ou Edit em um espaço de trabalho do Microsoft Access, ou um erro "Argumento inválido" ocorrerá na chamada Update em um espaço de trabalho ODBCDirect.