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

Artigo
08/01/2011

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
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto Windows Application.
Criar e configurar um DataSet com o Assistente de Configuração de Fonte de Dados.
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 Criando Aplicativos Baseados no Windows.

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 na dataset Designer clicando duas vezes o NorthwindDataSet 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 Demonstra 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..