Propriedade Field.ValidationRule (DAO)
Aplica-se ao: Access 2013, Office 2013
Define ou retorna um valor que valida os dados em um campo, conforme ele é alterado ou adicionado a uma tabela (apenas espaços de trabalho do Microsoft Access). String de leitura/gravação.
Sintaxe
expressão . Validationrule
Expressão Uma expressão que retorna um objeto Field .
Comentários
As configurações ou os valores de retorno são uma String que descreve uma comparação em um formulário da cláusula SQL WHERE sem a palavra reservada WHERE. Para um objeto ainda não acrescentado à coleção Fields, essa propriedade é de leitura/gravação.
A propriedade ValidationRule determina se um campo contém ou não dados válidos. Se os dados não forem válidos, ocorrerá um erro interceptável de tempo de execução. A mensagem de erro retornado será o texto da propriedade ValidationText, se especificado, ou o texto da expressão especificada por ValidationRule.
Para um objeto Field, o uso da propriedade ValidationRule depende do objeto que contém a coleção Fields na qual o objeto Field foi acrescentado.
Objeto acrescentado a |
Uso |
|---|---|
Índice |
Sem suporte |
QueryDef |
Somente leitura |
Recordset |
Somente leitura |
Relation |
Sem suporte |
TableDef |
Leitura/gravação |
Somente há suporte para a validação em bancos de dados que usam o mecanismo do banco de dados do Microsoft Access.
A expressão de cadeia de caracteres especificada pela propriedade ValidationRule de um objeto Field só pode se referir a esse Campo. A expressão não pode se referir às funções definidas pelo usuário, às funções agregadas SQL nem às consultas. Para definir a propriedade ValidationRule de um objeto Field quando sua configuração de propriedade ValidateOnSet for True, a expressão deve analisar com êxito (com o nome do campo como um operando implícito) e avaliar como True. Se a configuração de sua propriedade ValidateOnSet for False, a configuração da propriedade ValidationRule será ignorada.
Observação
Se você definir a propriedade como uma cadeia de caracteres concatenada com um valor não inteiro e os parâmetros do sistema especificar um não-eua. caractere decimal, como uma vírgula (por exemplo, strRule = "PRICE > " & lngPrice e lngPrice = 125,50), um erro resultará quando seu código tentar validar quaisquer dados. Isso ocorre porque, durante a concatenação, o número é convertido para uma sequência utilizando o caractere decimal padrão do seu sistema, e o mecanismo de banco de dados do Microsoft Access SQL aceita apenas caracteres decimais EUA.