Partilhar via


Demonstra Passo a passo: Adicionando validação a um conjunto de dados

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 descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Tarefas ilustradas nesta explicação 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 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

  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 Conexão Caixa de diálogo Box (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ção:

    Não defina a DataMember propriedade.

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 no arquivo NorthwindDataSet.xsd no Explorer solução.

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

    Clique duas vezes no (nome da tabela Detalhes do pedido na BAR de título) cria um manipulador de eventos para o RowChanging evento.

  3. Adicione código para verificar que 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

O que Há de Novo em Dados

Exibindo visão geral de dados

Outros recursos

Explicações Passo a passo sobre Dados

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Exibindo dados em formulários em aplicativos do Windows

Editar dados no seu aplicativo

Validando Dados

Salvando dados