Função Validate no PowerAppsValidate function in PowerApps

A função Validate verifica se o valor de uma coluna única ou de um registo completo é válido para uma origem de dados.The Validate function checks whether the value of a single column or a complete record is valid for a data source.

DescriçãoDescription

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.Before a user submits a data change, you can provide immediate feedback on the validity of that submission, resulting in a better user experience.

As origens de dados podem fornecer informações sobre o que constitui valores válidos dentro de um registo.Data sources can provide information on what constitutes valid values within a record. Estas informações podem incluir muitas restrições, tais como:This information can include many constraints, such as these examples:

  • se uma coluna necessita ou não de um valor;whether a column requires a value
  • o comprimento que uma cadeia de texto pode ter;how long a string of text can be
  • o número mínimo e máximo possíveis;how high and low a number can be
  • a data mais cedo e mais tarde possíveis.how early and late a date can be

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.The Validate function uses this information to determine whether a value is valid and to return an appropriate error message if not. Pode utilizar a função DataSourceInfo para ver as mesmas informações utilizadas pela função Validate.You can use the DataSourceInfo function to view the same information that Validate uses.

As origens de dados variam na quantidade de informações de validação que fornecem, incluindo o não fornecimento de qualquer informação.Data sources vary in how much validation information they provide, including not providing any at all. A função Validate só pode verificar valores com base nestas informações.Validate can only verify values based on this information. Mesmo que a função Validate não detete um problema, a aplicação da alteração dos dados poderá falhar.Even if Validate doesn't find a problem, applying the data change may still fail. Pode utilizar a função Errors para obter informações sobre a falha.You can use the Errors function to obtain information about the failure.

Se a função Validate detetar um problema, devolverá uma mensagem de erro que pode mostrar ao utilizador da aplicação.If Validate finds a problem, the function returns an error message that you can show to the user of the app. Se todos os valores forem válidos, a função Validate devolve em branco.If all values are valid, Validate returns 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.When you work with a collection that has no validation information, values are always valid.

SintaxeSyntax

Validate( OrigemDeDados, Coluna, Valor )Validate( DataSource, Column, Value )

  • OrigemDeDados – necessário.DataSource – Required. A origem de dados com a qual se validará.The data source to validate with.
  • Coluna – necessário.Column – Required. A coluna a validar.The column to validate.
  • Valor – necessário.Value – Required. O valor da coluna selecionada a validar.The value for the selected column to be validated.

Validate( OrigemDeDados, RegistoOriginal, Atualizações )Validate( DataSource, OriginalRecord, Updates )

  • OrigemDeDados – necessário.DataSource – Required. A origem de dados com a qual se validará.The data source to validate with.
  • RegistoOriginal – necessário.OriginalRecord - Required. O registo para o qual as atualizações serão validadas.The record to which updates are to be validated.
  • Atualizações – necessário.Updates - Required. As alterações a aplicar ao registo original.The changes to apply to the original record.

ExemplosExamples

Para estes exemplos, os valores na coluna Percentagem da origem de dados Pontuações têm de estar entre 0 e 100, inclusive.For these examples, values in the Percentage column of the Scores data source must be between 0 and 100, inclusive. Se os dados forem validados, a função devolve em branco.If the data passes validation, the function returns blank. Caso contrário, a função devolve uma mensagem de erro.Otherwise, the function returns an error message.

Validar com uma única colunaValidate with a single column

FórmulaFormula DescriçãoDescription ResultadoResult
Validate( Pontuações, Percentagem, 10 )Validate( Scores, Percentage, 10 ) Verifica se 10 é um valor válido para a coluna Percentagem da origem de dados Pontuações.Checks whether 10 is a valid value for the Percentage column in the Scores data source. em brancoblank
Validate( Pontuações, Percentagem, 120 )Validate( Scores, Percentage, 120 ) Verifica se 120 é um valor válido para a coluna Percentagem da origem de dados Pontuações.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Os valores têm de estar entre 0 e 100.""Values must be between 0 and 100."

Validar com um registo completoValidate with a complete record

FórmulaFormula DescriçãoDescription ResultadoResult
Validate( Pontuações, EditarRegisto, Galeria.Atualizações )Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 10 é um valor válido para a coluna Percentagem da origem de dados Pontuações.Checks whether 10 is a valid value for the Percentage column in the Scores data source. em brancoblank
Validate( Pontuações, EditarRegisto, Galeria.Atualizações )Validate( Scores, EditRecord, Gallery.Updates ) Verifica se 120 é um valor válido para a coluna Percentagem da origem de dados Pontuações.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Os valores têm de estar entre 0 e 100.""Values must be between 0 and 100."