Propriedade Recordset.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 do Recordset.

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.