Propriedade Recordset2.ValidationRule (DAO)
Aplica-se ao: Access 2013, Office 2013
Define ou retorna um valor que valida os dados em um campo à medida que estes são alterados ou adicionados a uma tabela (somente espaços de trabalho do Microsoft Access). String de leitura/gravação.
Sintaxe
expressão . Validationrule
Expressão Uma variável que representa um objeto Recordset2 .
Comentários
As configurações ou valores de retorno são um String que descreve uma comparação no formulário de uma cláusula SQL WHERE sem a palavra reservada WHERE. Para um objeto ainda não acrescentado à coleção Fields, essa propriedade será 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 retornada será o texto da propriedade ValidationText, se especificado, ou o texto da expressão especificada por ValidationRule.
Para um objeto Recordset, o uso da propriedade ValidationRule é somente leitura. Para um objeto TableDef, o uso da propriedade ValidationRule depende do status do objeto TableDef, como mostra a tabela a seguir.
TableDef |
Uso |
|---|---|
Tabela base |
Leitura/gravação |
Tabela vinculada |
Somente leitura |
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.
A propriedade ValidationRule de um objeto Recordset ou TableDef pode se referir a vários campos desse objeto. As restrições observadas anteriormente neste tópico do objeto Field são aplicáveis.
Para um Recordset do tipo tabela, a propriedade ValidationRule herda a definição de propriedade de ValidationRule do objeto TableDef usado para criar o objeto Recordset do tipo tabela.
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 acontecerá porque durante a concatenação, o número será convertido em uma sequência que usa o caractere decimal padrão do sistema e o Microsoft Access SQL aceita somente os caracteres decimais do padrão dos EUA.