Compartilhar via

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

  • Artigo

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çãoObservaçã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:

Pré-requisitos

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

Criando um novo aplicativo Windows

Para criar o novo projeto do Windows Application

  1. No menu File, crie um novo projeto.

  2. Nomeie o projeto como ValidationWalkthrough.

  3. 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

  1. No menu Data, clique em Show Data Sources.

  2. Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.

  3. Selecione Database na página Choose a Data Source Type, e clique Next.

  4. 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).

  5. Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

  6. Clique Next na página Save connection string to the Application Configuration file.

  7. Expanda o nó Tables na página Choose your Database Objects.

  8. 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

  1. Na janela Data Sources, selecione a tabela Order Details.

  2. Escolha Details na lista de controles da tabela.

  3. 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

  1. Arraste um ErrorProvider da Toolbox para Form1.

  2. Na janela Properties, defina a propriedade ErrorProvider do DataSource para o Order_DetailsBindingSource.

    ObservaçãoObservação

    Não defina a propriedade DataMember.

Criando o Manipulador de Eventos ColumnChanging

Para criar os manipuladores de eventos de validação

  1. Abra o NorthwindDataSet no Dataset Designer clicando duas vezes o NorthwindDataSet. xsd arquivo no Solution Explorer.

  2. 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çãoObservação

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

  3. 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

  1. Pressione F5 para executar o aplicativo.

  2. Altere o valor na caixa de texto Quantity para 0.

  3. Pressione TAB para mover o foco para fora da caixa de texto.

    O ícone do provedor de erros (error provider) aparecerá.

  4. 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:

Consulte também

Conceitos

Novidades para desenvolvimento de aplicativos de dados no Visual Studio 2012

Vinculando controles do Windows Forms a dados em Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo.

Controles de vinculação de dados de Visual Studio

Edição de dados em seu aplicativo.

Validação de dados

Salvar dados

Outros recursos

Explicações passo a passo de dados

Connecting to Data in Visual Studio