Função Validate

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo

A função Validate verifica se o valor de uma coluna única ou de um registo completo é válido para uma origem de dados.

Descrição

Antes de um utilizador submeter uma alteração de dados, pode fornecer imediatamente feedback sobre a validade dessa submissão, o que proporciona uma melhor experiência de utilizador.

As origens de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registo. Estas informações podem incluir muitas restrições, tais como:

• se uma coluna necessita ou não de um valor
• o comprimento que uma cadeia de texto pode ter
• o número mínimo e máximo possíveis
• a data mais cedo e mais tarde possíveis

A função Validate utiliza estas informações para determinar se um valor é válido, bem como para devolver uma mensagem de erro adequada caso o valor não seja válido. Pode utilizar a função DataSourceInfo para ver as mesmas informações utilizadas pela função Validate.

As origens de dados variam na quantidade de informações de validação que fornecem, incluindo o não fornecimento de qualquer informação. A função Validate só pode verificar valores com base nestas informações. Mesmo que a função Validate não detete um problema, a aplicação da alteração dos dados poderá falhar. Pode utilizar a função Errors para obter informações sobre a falha.

Se a função Validate detetar um problema, devolverá uma mensagem de erro que pode mostrar ao utilizador da aplicação. Se todos os valores forem válidos, a função Validate devolve blank. Quando se trabalha com uma coleção que não dispõe de informações de validação, os valores são sempre válidos.

Sintaxe

Validate( OrigemDeDados, Coluna, Valor )

• DataSource – Obrigatório. A origem de dados com a qual se validará.
• Coluna – Obrigatório. A coluna a validar.
• Value – Obrigatório. O valor da coluna selecionada a validar.

Validate( OrigemDeDados, RegistoOriginal, Atualizações )

• DataSource – Obrigatório. A origem de dados com a qual se validará.
• OriginalRecord – Obrigatório. O registo para o qual as atualizações serão validadas.
• Atualizações – Obrigatório. As alterações a aplicar ao registo original.

Exemplos

Para estes exemplos, os valores na coluna Percentagem da origem de dados Pontuações têm de estar entre 0 e 100, inclusive. Se os dados forem validados, a função devolve blank. Caso contrário, a função devolve uma mensagem de erro.

Validar com uma única coluna

Validar com um registo completo