Passo a passo: Adicionando validação a um Dataset.

Artigo
02/25/2013

Esta explicação passo a passo demonstra como validar dados quando alterações são feitas aos dados em um dataset.Onde você deve executar as verificações de validação em seus dados é dependente dos requisitos do seu aplicativo; para esta explicação passo a passo nós validamos dados durante as alterações dos valores nas colunas individuais.Essa explicação passo a passo usa o evento ColumnChanging para verificar que um valor aceitável está sendo inserido no registro.Se o valor não for válido, um controle ErrorProvider é exibido para o usuário.

O exemplo também mostra como usar o Dataset Designer para criar uma classe parcial para o dataset.(A classe parcial é onde os usuários podem adicionar código para estender a funcionalidade do dataset gerado pelo Visual Studio.Ela não é substituída se o dataset for regenerado.)

Observação
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 Configurações de Visual Studio.

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto Windows Application.
Criar e configurar um DataSet com o Data Source Configuration Wizard.
Selecionando o controle a ser criado no formulário ao arrastar itens a partir da janela Data Sources.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.
Criar um controle vinculado a dados arrastando itens da Janela fontes de dados para o formulário.
A criação de uma classe parcial para estender a funcionalidade do dataset.
Criar um manipulador de eventos para o evento ColumnChanging da tabela OrderDetails.
Adicionar validação para confirmar que a coluna Quantity contém valores maiores que 0.
Exibir um ErrorProvider Component (Windows Forms) para informar aos usuários que um controle vinculado a dados contém valores inválidos.

Pré-requisitos

Para concluir esta explicação passo a passo, você precisa:

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

Criando um novo aplicativo Windows

Para criar o novo projeto do Windows Application

No menu File, crie um novo projeto.
Nomeie o projeto como ValidationWalkthrough.
Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

O projeto ValidationWalkthrough é criado e adicionado ao Solution Explorer.

Criando uma Nova Fonte de Dados a partir de seu Banco de Dados

Para criar o DataSet

No menu Data, clique em Show Data Sources.
Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.
Selecione Database na página Choose a Data Source Type, e clique Next.
Na página Choose your Data Connection siga um destes procedimentos:
- Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.
  
  - ou -
- Selecione New Connection para iniciar a caixa Add/Modify Connection.Para obter mais informações, consulte Adicionar/modificar a caixa de diálogo de conexão (geral).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
Selecione a tabela Order Details, e clique em Finish.

O NorthwindDataSet é adicionado ao seu projeto e a tabela OrderDetails aparece na janela Data Sources.

Criando Controles Vinculados a Dados

Para criar controles ligados a dados no formulário

Na janela Data Sources, selecione a tabela Order Details.
Escolha Details na lista de controles da tabela.
Arraste o nó Order Details da janela Data Sources para Form1.

Controles vinculados a dados com rótulos descritivos aparecem no formulário, juntamente com uma faixa de ferramenta (BindingNavigator) para navegação em registros.Controles vinculados a dados com rótulos descritivos aparecem no formulário, juntamente com uma faixa de ferramenta (BindingNavigator) para navegação em registros.Um 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 Toolbox para Form1.
Na janela Properties, defina a propriedade ErrorProvider do DataSource para o Order_DetailsBindingSource.

Observação

Não defina a propriedade DataMember.

Observação
Não defina a propriedade DataMember.

Criando o Manipulador de Eventos ColumnChanging

Para criar os manipuladores de eventos de validação

Abra o NorthwindDataSet no Dataset Designer clicando duas vezes o NorthwindDataSet. xsd arquivo no Solution Explorer.
Clique duas vezes a coluna Quantity na tabela OrderDetails para criar o manipulador de eventos OrderDetailsDataTable_ColumnChanging.(Em C# somente classe parcial da tabela de dados será criada.)

Observação

Clicar duas vezes no nome da tabela (Order Details na barra de título) cria um manipulador de eventos para o evento RowChanging.

Observação
Clicar duas vezes no nome da tabela (Order Details 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 maiores que 0.Se o valor proposto for 0 ou menos, marque a coluna para indicar que ela contém um erro.

Cole o código a seguir no manipulador de eventos de alteração de coluna (column-changing) sob o comentário Add user code here:

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 na caixa de texto Quantity para 0.
Pressione TAB para mover o foco para fora da caixa de texto.

O ícone do provedor de erros (error provider) aparecerá.
Posicione o ponteiro do mouse sobre o provedor de erros para ver a mensagem.

Próximas etapas

Dependendo dos seus requisitos de aplicativo, há várias etapas que você pode desejar executar após adicionar validação.Alguns aprimoramentos que você poderia fazer a essa explicação passo a passo incluem:

Adicionar funcionalidade para enviar atualizações de volta para o banco de dados.Para obter mais informações, consulte Passo a passo: Salvando dados em um banco de dados (Single Table).
Edição do dataset para adicionar ou remover objetos de banco de dados.Para obter mais informações, consulte Como: editar um conjunto de dados..