Validate Função

Aplica-se a: Aplicativos de tela Aplicativos orientados por modelos

A Validate função verifica se o valor de uma única coluna ou de um registro completo é válido para uma fonte 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 Validate função usa essas informações para determinar se um valor é válido e para retornar uma mensagem de erro apropriada, se não. Você pode usar a função DataSourceInfo para exibir as mesmas informações que Validate usa.

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

Se Validate encontrar um problema, a função retorna uma mensagem de erro que você pode mostrar ao usuário do aplicativo. Se todos os valores forem válidos, Validate retorna em branco. 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( DataSource, Coluna, Valor )

• 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.

Validate( DataSource, OriginalRecord, 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.

Validate com uma única coluna

Validate com um registo completo