Como: Validar dados durante alterações de linha

Artigo
08/01/2011

Validação de dados é o processo de verificação dos valores sendo inseridos em seus dados de aplicativos. É uma boa prática verificar esses valores antes de mandar as atualizações ao armazenamento de dados subjacente. Isso reduz o número potencial de processamentos entre um aplicativo e o armazenamento de dados.

Observação
O Dataset Designer cria uma classe parcial onde a lógica da validação pode ser adicionada a um dataset. O dataset gerado pelo designer não excluirá ou alterará qualquer código na classe parcial.

Você pode validar os dados quando os valores em uma linha de dados mudam respondendo ao evento RowChanging. Quando gerado, esse evento passa um argumento do evento (e.Row) que contém os valores que estão sendo propostos para cada coluna na linha atual. Com base no conteúdo de cada coluna no e.Row, você pode:

Aceitar o valor proposto, sem fazer nada.
Rejeitar o valor proposto, definindo o erro de coluna (SetColumnError) de dentro do manipulador de eventos de alteração de colunas.
Opcionalmente, use um controle ErrorProvider para exibir um mensagem de erro para o usuário. Para obter mais informações, consulte ErrorProvider Component (Windows Forms).

Você também pode executar a validação durante alterações de colunas individuais usando o evento ColumnChanging. Para obter mais informações, consulte Como: Validar dados durante alterações de coluna.

Validar Dados no Evento RowChanging

Você pode escrever código para verificar se cada coluna que você deseja validar contém dados que atendam aos requisitos do seu aplicativo. Se o valor proposto é inaceitável, configure a coluna para indicar que ele contém um erro. Os exemplos a seguir definem um erro de coluna quando a coluna Quantity é 0 ou menos. Os manipuladores de eventos de alteração de linha devem se parecer com os exemplos a seguir.

Para validar dados quando uma linha altera (Visual Basic)

Abra o DataSet no Dataset Designer. Para obter mais informações, consulte Como: Abra um Dataset no Dataset Designer.
Clique duas vezes na barra de título da tabela que você deseja validar. Essa ação cria automaticamente o manipulador de eventos RowChanging da DataTable no arquivo de classe parcial do DataSet.

Dica

Clique duas vezes para a esquerda no nome da tabela para criar o manipulador de eventos de linha alterada. Se você clicar duas vezes o nome da tabela, você pode editar o nome da tabela.
```
Private Sub Order_DetailsDataTable_Order_DetailsRowChanging(
    ByVal sender As System.Object, 
    ByVal e As Order_DetailsRowChangeEvent
  ) Handles Me.Order_DetailsRowChanging

    If CType(e.Row.Quantity, Short) <= 0 Then
        e.Row.SetColumnError("Quantity", "Quantity must be greater than 0")
    Else
        e.Row.SetColumnError("Quantity", "")
    End If
End Sub
```

Para validar dados quando uma linha altera (C#)

Abra o DataSet no Dataset Designer. Para obter mais informações, consulte Como: Abra um Dataset no Dataset Designer.

Clique duas vezes na barra de título da tabela que você deseja validar. Essa ação cria um arquivo de classe parcial para a DataTable.

Observação
O Dataset Designer não cria automaticamente um manipulador de eventos para o evento RowChanging. Você precisa criar um método para manipular o evento RowChanging e executar o código para ligar o evento no método de inicialização da tabela.

Copie o código a seguir na classe parcial:

    public override void EndInit()
    {
        base.EndInit();
        Order_DetailsRowChanging += TestRowChangeEvent;
    }

    public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
    {
        if ((short)e.Row.Quantity <= 0)
        {
            e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
        }
        else
        {
            e.Row.SetColumnError("Quantity", "");
        }
    }

Consulte também

Compartilhar via

Como: Validar dados durante alterações de linha

Validar Dados no Evento RowChanging

Para validar dados quando uma linha altera (Visual Basic)

Para validar dados quando uma linha altera (C#)

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais