Partilhar via


Função Validate

Aplica-se a: Aplicativos de tela Aplicativos controlados 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. Validar só pode verificar valores com base nessas 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

Validar(DataSource,Column,Value )

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

Validar(DataSource,OriginalRecord,Updates )

  • 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

Fórmula Descrição Resultado
Validar( Pontuação, Porcentagem, 10 ) Verifica se 10 é um valor válido para a coluna Percentagem da origem de dados Pontuações. em branco
Validar( Pontuação, Porcentagem, 120 ) Verifica se 120 é um valor válido para a coluna Percentagem da origem de dados Pontuações. "Os valores têm de estar entre 0 e 100."

Validar com um registo completo

Fórmula Descrição Resultado
Validate( Partituras, EditRecord, Gallery.Updates ) Verifica se os valores em todas as colunas são válidos para a origem de dados Pontuações. Neste exemplo, o valor na coluna Percentagem é 10. em branco
Validate( Partituras, EditRecord, Gallery.Updates ) Verifica se os valores em todas as colunas são válidos para a origem de dados Pontuações. Neste exemplo, o valor na coluna Percentagem é 120. "Os valores têm de estar entre 0 e 100."