Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O evento BeforeUpdate ocorre antes de os dados alterados em um controle ou registro serem atualizados.
Sintaxe
expressão. BeforeUpdate (Cancelar)
Expressão Uma variável que representa um objeto Attachment .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Cancel | Obrigatório | Integer | A configuração determina se o evento BeforeUpdate ocorre. Definir o argumento Cancelar como True (1) cancela o evento BeforeUpdate . |
Valor de retorno
Nada
Comentários
Alterar dados em um controle usando o Visual Basic ou uma macro que contém a ação DefinirValor não dispara esses eventos para o controle. No entanto, se você move para outro registro ou salva o registro, o evento BeforeUpdate do formulário ocorrer.
O evento BeforeUpdate só se aplica a controles em um formulário, não a controles em um relatório.
Para executar uma macro ou procedimento de evento quando esse evento ocorrer, defina a propriedade BeforeUpdate como o nome da macro ou para [Procedimento de Evento].
O evento BeforeUpdate é acionado quando um controle ou registro é atualizado. Em um registro, os dados alterados em cada controle são atualizados quando o controle perde o foco ou quando o usuário pressiona Enter ou Tab. Quando o foco sai do registro ou se o usuário escolhe Salvar Registro no menu Registros , todo o registro é atualizado e os dados são salvos no banco de dados.
Quando você insere dados novos ou alterados em um controle em um formulário e depois passa para outro registro ou salva o registro escolhendo Salvar Registro no menu Registros , o evento AfterUpdate para o formulário ocorre imediatamente após o evento AfterUpdate para o controle. Quando você move para um registro diferente, os eventos Exit e LostFocus do controle ocorrem, seguido pelo evento Current para o registro que você moveu para e os eventos Enter e GotFocus para o primeiro controle nesse registro. Para executar a macro ApósAtualizar ou procedimento de evento sem executar as macros Exit e LostFocus ou procedimentos de evento, salve o registro usando o comando Salvar registro no menu registros.
BeforeUpdate macros e procedimentos de evento executar somente se você alterar os dados em um controle. Esse evento não ocorre quando um valor é alterado em um controle calculado. BeforeUpdate macros e procedimentos de evento para um formulário executar somente se você alterar os dados em um ou mais controles no registro.
Se o usuário insere um novo valor no controle, a configuração da propriedade OldValue não será alterada até que os dados são salvos (o registro é atualizado). Se você cancelar uma atualização, o valor da propriedade OldValue substituirá o valor existente no controle.
Geralmente você utilizar o evento BeforeUpdate para validar dados, especialmente quando são efetuadas validações complexas, como as que:
- Envolvem condições para mais de um valor em um formulário.
- Exibem mensagens de erro distintas à medida que dados diferentes são inseridos.
- Podem ser substituídas pelo usuário.
- Contêm referências a controles de outros formulários ou contêm funções definidas pelo usuário.
Um erro de tempo de execução ocorre se você tentar modificar os dados contidos no controle que disparou o evento BeforeUpdate no procedimento do evento.
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.