Instruções passo a passo: adicionando validação a um conjunto de dados

Artigo
06/10/2015

Este passo a passo demonstra como validar dados quando são feitas alterações a eles em um conjunto de dados. Os pontos nos quais é preciso executar verificações de validação em seus dados dependem dos requisitos do aplicativo. Para este passo a passo, validamos dados durante alterações nos valores em colunas individuais. Este passo a passo usa o evento ColumnChanging para verificar se um valor aceitável está sendo inserido no registro. Se o valor não for válido, um controle ErrorProvider será exibido ao usuário.

O exemplo mostra também como usar o Designer de Conjunto de Dados para criar uma classe parcial para o conjunto de dados. (A classe parcial é onde os usuários podem adicionar código para estender a funcionalidade do conjunto de dados gerado pelo Visual Studio. Não será sobrescrito se o conjunto de dados for gerado novamente.)

Dica

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto de Aplicativo do Windows.
Criando e configurando um conjunto de dados com o Assistente para Configuração da Fonte de Dados.
Selecionando o controle a ser criado no formulário ao arrastar itens da janela Fontes de Dados. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.
Criando um controle de associação de dados ao arrastar itens da Janela Fontes de Dados para seu formulário.
Criando uma classe parcial para estender a funcionalidade do conjunto de dados.
Criando um manipulador de eventos para o evento ColumnChanging da tabela OrderDetails.
Adicionando validação para confirmar se a coluna Quantity contém valores maior que 0.
Exibindo um Componente ErrorProvider (Windows Forms) para informar aos usuários que um controle de associação de dados contém valores inválidos.

Pré-requisitos

Para concluir este passo a passo, você precisará de:

Acesso ao banco de dados de exemplo Northwind. Para obter mais informações, consulte Como instalar bancos de dados de exemplo.

Criando um novo Aplicativo do Windows

Para criar o novo projeto de Aplicativo do Windows

No menu Arquivo, crie um novo projeto.
Nomeie o projeto como ValidationWalkthrough.
Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

O projeto ValidationWalkthrough é criado e adicionado ao Gerenciador de Soluções.

Criando uma nova fonte de dados a partir de seu banco de dados

Para criar a fonte de dados

No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.
Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.
Na página Escolha a Conexão de Dados, faça o seguinte:
- Se uma conexão de dados com o banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.
  
  -ou-
- Selecione Nova Conexão para iniciar a caixa Adicionar/Modificar Conexão.
Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.
Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.
Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.
Selecione a tabela Detalhes do Pedido e clique em Concluir.

O NorthwindDataSet é adicionado ao projeto e a tabela OrderDetails aparece na janela Fontes de Dados.

Criando controles de associação de dados

Para criar controles de associação de dados no formulário

Na janela Fontes de Dados, selecione a tabela Detalhes do Pedido.
Escolha Detalhes na lista de controles da tabela.
Arraste o nó Detalhes do Pedido da janela Fontes de Dados para Form1.

Os controles de associação de dados com rótulos descritivos são exibidos no formulário, juntamente com uma faixa de ferramentas (BindingNavigator) para registros de navegação. Os controles de associação de dados com rótulos descritivos são exibidos no formulário, juntamente com uma faixa de ferramentas (BindingNavigator) para registros de navegação. NorthwindDataSet, Order_DetailsTableAdapter, BindingSource, e BindingNavigator aparecem na bandeja de componentes.

Adicionando um controle ErrorProvider ao formulário

Para configurar um controle ErrorProvider

Arraste um ErrorProvider da Caixa de Ferramentas para Form1.
Na janela Propriedades, defina a propriedade DataSource de ErrorProvider como Order_DetailsBindingSource.

Dica

Não defina a propriedade DataMember.

Criando o manipulador de eventos ColumnChanging

Para criar manipuladores de eventos de validação

Abra o NorthwindDataSet no Designer de Conjunto de Dados clicando duas vezes no arquivo NorthwindDataSet.xsd no Gerenciador de Soluções.
Clique duas vezes na coluna Quantity na tabela OrderDetails para criar o manipulador de eventos OrderDetailsDataTable_ColumnChanging. (Em C#, somente a classe parcial da tabela de dados será criada.)

Dica

Um clique duplo no nome da tabela (Detalhes do Pedido na barra de título) cria um manipulador de eventos para o evento RowChanging.

Adicione código para verificar se e.ProposedValue contém valores superiores a 0. Se o valor proposto for 0 ou menos, defina a coluna para indicar que ele contém um erro.

Cole o seguinte código no manipulador de eventos de alteração de colunas abaixo do comentário Adicionar código do usuário aqui:

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

// C#
// Add the following code 
// to the partial class.
    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", "");
        }
    }

Testando o aplicativo

Para testar o aplicativo

Pressione F5 para executar o aplicativo.
Altere o valor da caixa de texto Quantidade para 0.
Pressione TAB para mover o foco para fora da caixa de texto.

O ícone do provedor de erros aparece.
Posicione o ponteiro do mouse sobre o provedor de erros para ver a mensagem.

Próximas etapas

Dependendo dos requisitos de aplicativo, existem várias etapas que talvez queira realizar após adicionar a validação. Entre algumas das melhorias que você poderia fazer nessa explicação passo a passo estão:

Adicionando a funcionalidade para enviar atualizações de volta ao banco de dados. Para obter mais informações, consulte Instruções passo a passo: salvando dados em um banco de dados (tabela única).
Editando o conjunto de dados para adicionar ou remover objetos de banco de dados. Para obter mais informações, consulte Como editar um conjunto de dados.