Função Validate
Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo
A função Validate verifica se o valor de uma única coluna ou um registro completo é válido para uma fonte de dados.
Descrição
Antes que um usuário envie uma alteração de dados, você pode fornecer um feedback imediato sobre a validade desse envio, resultando em uma melhor experiência para o usuário.
Fontes de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registro. Essas informações podem incluir muitas restrições, conforme os exemplos a seguir:
- se uma coluna requer um valor
- o comprimento máximo de uma cadeia de caracteres
- limites mínimo e máximo de um número
- limites mínimo e máximo de uma data
A função Validate usa essas informações para determinar se um valor é válido e retornar uma mensagem de erro apropriada se o valor não for válido. Você pode usar a função DataSourceInfo para exibir as mesmas informações que a função Validate.
As fontes de dados variam em quantas informações de validação elas fornecem, incluindo não fornecer nenhuma. A função Validate só pode verificar valores com base nessas informações. Mesmo se Validate não encontrar um problema, a aplicação da alteração de dados ainda poderá falhar. Você pode usar a função Errors para obter informações sobre a falha.
Se a função Validate encontrar um problema, a função retornará uma mensagem de erro que você pode mostrar ao usuário do aplicativo. Se todos os valores forem válidos, a função Validate retorna blank. Quando você trabalha com um coleção que não possui nenhuma informação de validação, os valores são sempre válidos.
Sintaxe
Validate( DataSource, Column, Value )
- DataSource - obrigatório. A fonte de dados usada para a validação.
- Column - obrigatório. A coluna a ser validada.
- Value - obrigatório. O valor para a coluna selecionada a ser validado.
Validate( DataSource, OriginalRecord, Updates )
- DataSource - obrigatório. A fonte de dados usada para a validação.
- OriginalRecord - obrigatório. O registro para o qual as atualizações devem ser validadas.
- Updates - obrigatório. As alterações a serem aplicadas ao registro original.
Exemplos
Para esses exemplos, os valores na coluna porcentagem da fonte de dados de Pontuações deve estar entre 0 e 100, inclusive. Se os dados passam na validação, a função retorna em branco. Caso contrário, a função retornará uma mensagem de erro.
Validar com uma única coluna
Fórmula | Descrição | Resultado |
---|---|---|
Validate( Scores, Percentage, 10 ) | Verifica se 10 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. | blank |
Validate( Scores, Percentage, 120 ) | Verifica se 120 é um valor válido para a coluna Porcentagem na fonte de dados de Pontuações. | “Os valores devem estar entre 0 e 100”. |
Validar com um registro completo
Fórmula | Descrição | Resultado |
---|---|---|
Validate( Scores, EditRecord, Gallery.Updates ) | Verifica se os valores em todas as colunas são válidos para a fonte de dados de Pontuações. Neste exemplo, o valor da coluna Percentual é 10. | blank |
Validate( Scores, EditRecord, Gallery.Updates ) | Verifica se os valores em todas as colunas são válidos para a fonte de dados de Pontuações. Neste exemplo, o valor da coluna Percentual é 120. | “Os valores devem estar entre 0 e 100”. |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de