Table of contents
TOC
Recolher sumário
Expandir sumário

Propriedade ComboBox.ValidationText (Access)ComboBox.ValidationText Property (Access)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Use a propriedade ValidationText para especificar uma mensagem a ser exibido para o usuário quando os dados são inseridos que viola uma configuração de ValidationRule para um registro, campo ou controle. Cadeia de caracteresde leitura/gravação.Use the ValidationText property to specify a message to be displayed to the user when data is entered that violates a ValidationRule setting for a record, field, or control. Read/write String.

SintaxeSyntax

expressão. ValidationTextexpression. ValidationText

expressão Uma variável que representa um objeto ComboBox .expression A variable that represents a ComboBox object.

ComentáriosRemarks

Insira uma expressão para a configuração da propriedade ValidationRule e texto para a configuração da propriedade ValidationText . O comprimento máximo para a configuração da propriedade ValidationRule é 2048 caracteres. O comprimento máximo para a configuração da propriedade ValidationText é 255 caracteres.Enter an expression for the ValidationRule property setting and text for the ValidationText property setting. The maximum length for the ValidationRule property setting is 2048 characters. The maximum length for the ValidationText property setting is 255 characters.

Para controles, você pode definir a propriedade ValidationRule para qualquer expressão válida. Para regras de validação de registro e de campo, a expressão não pode conter funções definidas pelo usuário, domínio agregado ou funções agregadas, a função Eval , ou método CurrentUser ou referências a formulários, consultas ou tabelas. Além disso, as regras de validação de campo não podem conter referências a outros campos. Para registros, expressões podem incluir referências a campos na tabela que.For controls, you can set the ValidationRule property to any valid expression. For field and record validation rules, the expression can't contain user-defined functions, domain aggregate or aggregate functions, the Eval function, or CurrentUser method, or references to forms, queries, or tables. In addition, field validation rules can't contain references to other fields. For records, expressions can include references to fields in that table.

Para registros e campos de tabela, você também pode definir essas propriedades no Visual Basic usando a propriedade ValidationRule do DAO.For table fields and records, you can also set these properties in Visual Basic by using the DAO ValidationRule property.

O Microsoft Access valida automaticamente valores com base no tipo de dados de um campo; Por exemplo, o Microsoft Access não permite texto em um campo numérico. Você pode definir as regras que são mais específicas usando a propriedade ValidationRule .Microsoft Access automatically validates values based on a field's data type; for example, Microsoft Access doesn't allow text in a numeric field. You can set rules that are more specific by using the ValidationRule property.

Se você definir a propriedade ValidationRule , mas não a propriedade ValidationText , o Microsoft Access exibe uma mensagem de erro padrão quando a regra de validação for violada. Se você definir a propriedade TextoDeValidação , o texto inserido é exibido como a mensagem de erro.If you set the ValidationRule property but not the ValidationText property, Microsoft Access displays a standard error message when the validation rule is violated. If you set the ValidationText property, the text you enter is displayed as the error message.

Por exemplo, quando um registro é adicionado para um novo funcionário, você pode inserir uma propriedade de ValidationRule exigir que o valor no campo de data de início do funcionário situados entre data de fundação da empresa e a data atual. Se a data inserida não estiver nesse intervalo, você pode exibir a mensagem da propriedade ValidationText : "data de início está incorreta".For example, when a record is added for a new employee, you can enter a ValidationRule property requiring that the value in the employee's StartDate field fall between the company's founding date and the current date. If the date entered isn't in this range, you can display the ValidationText property message: "Start date is incorrect."

Se você criar um controle arrastando um campo da lista de campos, regra de validação do campo permanece em vigor, embora ele não é exibido na caixa de propriedade de ValidationRule do controle na folha de propriedades. Isso ocorre porque a regra de validação de um campo é herdada por um controle acoplado a esse campo.If you create a control by dragging a field from the field list, the field's validation rule remains in effect, although it isn't displayed in the control's ValidationRule property box in the property sheet. This is because a field's validation rule is inherited by a control bound to that field.

As regras de validação de controle, campo e registro são aplicadas como a seguir:Control, field, and record validation rules are applied as follows:

  • As regras de validação definidas para campos e controles são aplicadas quando você edita os dados e o foco deixa o campo ou controle.Validation rules you set for fields and controls are applied when you edit the data and the focus leaves the field or control.

  • As regras de validação de registros são aplicadas quando você vai para um outro registro.Validation rules for records are applied when you move to another record.

  • Se você criar regras de validação tanto para um campo quanto para um controle acoplado ao campo, ambas as regras de validação serão aplicadas quando você editar dados e o foco deixar o controle.If you create validation rules for both a field and a control bound to the field, both validation rules are applied when you edit data and the focus leaves the control.

A tabela a seguir contém exemplos de expressões para as propriedades ValidationRule e ValidationText .The following table contains expression examples for the ValidationRule and ValidationText properties.

Propriedade ValidationRuleValidationRule propertyPropriedade ValidationTextValidationText property
<> 0<> 0A entrada precisa ser um valor diferente de zero.Entry must be a nonzero value.
> 1000 Ou É Nulo> 1000 Or Is NullA entrada precisa ser vazia ou maior que 1000.Entry must be blank or greater than 1000.
Como "A????"Like "A????"A entrada precisa ser de 5 caracteres e começar com a letra "A".Entry must be 5 characters and begin with the letter "A".
>= #1/1/96# E <#1/1/97#>= #1/1/96# And <#1/1/97#A entrada precisa ser uma data de 1996.Entry must be a date in 1996.
DLookup("CustomerID", "Customers", "CustomerID = Forms!Customers!CustomerID") É NuloDLookup("CustomerID", "Customers", "CustomerID = Forms!Customers!CustomerID") Is NullA entrada precisa ser um CódigoCliente exclusivo (funções agregadas de domínio só são permitidas para validação em nível de formulário).Entry must be a unique CustomerID (domain aggregate functions are allowed only for form-level validation).

Se você criar uma regra de validação de um campo, o Microsoft Access normalmente não permite que um valor Nulo a serem armazenados no campo. Se você quiser permitir que um valor Nulo , adicione "É nulo" à regra de validação, como em "<> 8 ou é nulo" e verifique se a propriedade Required está definida como não.If you create a validation rule for a field, Microsoft Access doesn't normally allow a Null value to be stored in the field. If you want to allow a Null value, add "Is Null" to the validation rule, as in "<> 8 Or Is Null" and make sure the Required property is set to No.

Não é possível definir regras de validação de campo ou de registro para tabelas criadas fora do Microsoft Access (por exemplo, no dBASE, Paradox ou SQL Server). Para esses tipos de tabelas, você pode criar regras de validação somente para controles.You can't set field or record validation rules for tables created outside Microsoft Access (for example, dBASE, Paradox, or SQL Server). For these kinds of tables, you can create validation rules for controls only.

ExemploExample

O exemplo a seguir cria uma regra de validação para um campo que permite que somente valores acima de 65 sejam inseridos. Se um número menor que 65 for inserido, uma mensagem será exibida. As propriedades são definidas pela utilização da função SetFieldValidation.The following example creates a validation rule for a field that allows only values over 65 to be entered. If a number less than 65 is entered, a message is displayed. The properties are set by using the SetFieldValidation function.

Dim strTblName As String, strFldName As String 
Dim strValidRule As String 
Dim strValidText As String, intX As Integer 

strTblName = "Customers" 
strFldName = "Age" 
strValidRule = ">= 65" 
strValidText = "Enter a number greater than or equal to 65." 
intX = SetFieldValidation(strTblName, strFldName, _ 
 strValidRule, strValidText) 

Function SetFieldValidation(strTblName As String, _ 
 strFldName As String, strValidRule As String, _ 
 strValidText As String) As Integer 

 Dim dbs As Database, tdf As TableDef, fld As Field 

 Set dbs = CurrentDb 
 Set tdf = dbs.TableDefs(strTblName) 
 Set fld = tdf.Fields(strFldName) 
 fld.ValidationRule = strValidRule 
 fld.ValidationText = strValidText 
End Function

O exemplo a seguir utiliza a função SetTableValidation para definir validação em nível de registro a fim de garantir que o valor do campo EndDate seja posterior ao valor do campo StartDate.The next example uses the SetTableValidation function to set record-level validation to ensure that the value in the EndDate field comes after the value in the StartDate field.

Dim strTblName As String, strValidRule As String 
Dim strValidText As String 
Dim intX As Integer 

strTblName = "Employees" 
strValidRule = "EndDate > StartDate" 
strValidText = "Enter an EndDate that is later than the StartDate." 
intX = SetTableValidation(strTblName, strValidRule, strValidText) 

Function SetTableValidation(strTblName As String, _ 
 strValidRule As String, strValidText As String) _ 
 As Integer 

 Dim dbs As Database, tdf As TableDef 

 Set dbs = CurrentDb 
 Set tdf = dbs.TableDefs(strTblName) 
 tdf.ValidationRule = strValidRule 
 tdf.ValidationText = strValidText 
End Function

Ver tambémSee also

ConceitosConcepts

Objeto ComboBoxComboBox Object

© 2018 Microsoft