Adicionando validação

Artigo
02/25/2013

Esta lição mostra como validar os dados que um usuário insere em um aplicativo LightSwitch.

Adicionando Validação de Dados

Em praticamente qualquer aplicativo que envolva entrada de dados, os dados devem ser validados antes de serem salvos.Por exemplo, você pode querer verificar se um número de telefone contém o número correto de dígitos ou que um campo obrigatório não está vazio.

O Designer de Dados contém um exemplo de um tipo de validação: cada campo de entidade possui uma caixa de seleção Obrigatório.Se um campo está marcado como obrigatório e o campo está vazio, o LightSwitch automaticamente exibe um aviso quando o usuário tenta salvar os dados.

Você também pode lidar com a validação no LightSwitch, definindo propriedades de validação ou escrevendo um código de validação personalizado.

Para definir propriedades de validação

No Gerenciado de Soluções, dê um clique duplo em Contatos.
No Designer de Dados, clique em <Adicionar Propriedade> e digite ContactState.
Certifique-se de que o tipo é String.
Na janela Propriedades, selecione a propriedade Comprimento Máximo e digite 2.

Esta configuração garante que não mais de dois caracteres possam ser digitados no campo ContactState.

Para adicionar um código de validação personalizado

No Gerenciador de Soluções, clique duas vezes em Order_Details.
No Designer de Dados, selecione o campo Quantidade.
Na janela Propriedades, clique no link Validação Personalizada.

O Editor de Código abre e um bloco de códigos para o método Quantity_Validate é exibido.
Adicione o seguinte código ao método Quantity_Validate logo abaixo da linha de comentário.

Cuidado

Adicione um código Visual Basic ou C#, dependendo da linguagem de programação que foi escolhida quando o projeto foi criado.
```
If Quantity < 1 Then
    results.AddPropertyError("Quantity must be greater than zero.")
End If
```
```
if (Quantity < 1) 
{
    results.AddPropertyError("Quantity must be greater than zero.");
}
```
Este código garante que um valor menor que um no campo Quantidade não pode ser salvo.Se um usuário tentar salvar um valor menor que um, um erro de validação é acionado.

Cuidado
Adicione um código Visual Basic ou C#, dependendo da linguagem de programação que foi escolhida quando o projeto foi criado.

Visão aprofundada

Esta lição mostrou como validar dados definindo propriedades de validação ou escrevendo códigos de validação.Propriedades de validação diferentes estão disponíveis para diferentes tipos de dados.Por exemplo, um tipo String tem uma propriedade Comprimento máximo e um Integer tem propriedades Valor Mínimo e Valor máximo.Todos os tipos têm uma propriedade É obrigatório, que é a propriedade que é usada para a caixa de seleção Obrigatório no Designer de Dados.

Se você examinar a entidade Clientes, observe que as propriedades de validação aparecem esmaecidas e não podem ser alteradas.Alguns campos, como Endereço, já possuem um valor na propriedade Comprimento Máximo.Você não pode definir propriedades de validação em uma entidade de uma fonte de dados anexada; você pode defini-las apenas nas entidades que você criar.

Se você deseja adicionar validação para uma entidade de uma fonte de dados anexada, você pode fazer isso escrevendo o seu próprio código de validação.Você não pode sobrescrever propriedades de validação existentes, a menos que você esteja adicionando uma validação mais restritiva.Por exemplo, para um campo que tem um Comprimento Máximo de 30, você não pode adicionar um código de validação para definir o comprimento para 40.No entanto, você pode adicionar um código para restringir o tamanho para um valor menor do que 30.