Compartilhar via

Passo a passo: Criando um formulário do Windows para pesquisar dados

  • Artigo

Um cenário de aplicativo comum é exibir dados selecionados em um formulário.Por exemplo, você pode desejar exibir os pedidos para um cliente específico ou os detalhes de uma ordem específica.Nesse cenário, um usuário insere informações em um formulário, e em seguida, uma consulta é executada com a entrada do usuário como parâmetro; ou seja, os dados são selecionados com base em uma consulta parametrizada.A consulta retorna somente os dados que satisfizerem aos critérios inseridos pelo usuário.Esta explicação passo a passo mostra como criar uma consulta que retorne clientes de uma cidade específica, e modifica a interface do usuário para que os usuários possam inserir um nome de cidade e pressionar um botão para executar a consulta.

Usar consultas parametrizadas ajuda a tornar seu aplicativo eficiente, permitindo que o banco de dados faça o trabalho no qual ele é melhor — filtrar registros rapidamente.Se, em contrapartida, você solicitar um tabela de banco de dados inteira, transferi-la através da rede, e em seguida, usar lógica do aplicativo para encontrar os registros que você deseja, seu aplicativo pode se tornar lento ineficiente.

Você pode adicionar consultas parametrizadas a qualquer TableAdapter (e os controles para aceitar valores de parâmetro e executar a consulta) usando o Search Criteria Builder Dialog Box.Abra a caixa de diálogo selecionando o comando Add Query no menu Data (ou em qualquer marca inteligente TableAdapter).

As tarefas ilustradas neste passo a passo incluem:

Pré-requisitos

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

Criando o aplicativo Windows

A primeira etapa é criar um Windows Application.Atribuir um nome para o projeto é opcional nesta etapa mas nós daremos um nome porque nós estamos planejando salvá-lo posteriormente.

Para criar o novo projeto do Windows Application

  1. No menu File, crie um novo projeto.

  2. Nomeie o projeto como WindowsSearchForm.

  3. Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

    O projeto WindowsSearchForm projeto é criado e adicionado ao Solution Explorer.

Criando o DataSet

Essa etapa cria uma fonte de dados a partir de um banco de dados usando o Data Source Configuration Wizard.Você deve ter acesso ao banco de dados de exemplos Northwind para criar a conexão.Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como: instalar bancos de dados de amostra.

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 Customers, e clique Finish.

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

Criando o formulário

Você pode criar os controles com dados vinculados, arrastando itens da janela Data Sources para seu formulário.

Para criar controles vinculado a dados no formulário

  1. Expanda o nó Customers na janela Data Sources.

  2. Arraste o nó Customers da janela Data Sources para seu formulário.

    Um DataGridView e uma faixa de ferramenta (BindingNavigator) para navegação em registros aparecem no formulário.Um NorthwindDataSet,CustomersTableAdapter, BindingSource e BindingNavigator aparecem na bandeja de componentes.

Adicionando Parametrização (funcionalidade de pesquisa) à Consulta

Você pode adicionar uma cláusula WHERE para a consulta original usando o Search Criteria Builder Dialog Box.

Para criar uma consulta parametrizada e controles para inserir os parâmetros

  1. Selecione o controle DataGridView e então escolha Add Query no menu Data.

  2. Digite FillByCity na área de New query name em Search Criteria Builder Dialog Box.

  3. Adicione WHERE City = @City à consulta na área Query Text.

    A consulta deve ser semelhante à seguinte:

    SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax

    FROM Customers

    WHERE City = @City

    ObservaçãoObservação

    Fontes de dados OleDb e Access usam o ponto de interrogação '?' para denotar parâmetros, de forma que a cláusula WHERE teria esta aparência: WHERE City = ?.

  4. Clique OK para fechar a caixa de diálogo Search Criteria Builder.

    Uma FillByCityToolStrip é adicionado ao formulário.

Testando o aplicativo

Executar o aplicativo abre o formulário pronto para receber o parâmetro como entrada.

Para testar o aplicativo

  1. Pressione F5 para executar o aplicativo.

  2. Digite London para o City caixa de texto e clique FillByCity.

    A grade de dados é preenchida com clientes que atendem aos critérios de parametrização.Neste exemplo, a grade de dados exibe clientes que têm um valor London na sua coluna City.

Próximas etapas

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

Consulte também

Referência

Visão geral sobre o componente BindingSource

Visão geral do controle BindingNavigator (Windows Forms)

Conceitos

Novidades para desenvolvimento de aplicativos de dados no Visual Studio 2012

Vinculando controles do Windows Forms a dados em Visual Studio

Visão geral sobre fontes de dados

Visão geral do TableAdapter

Outros recursos

Explicações passo a passo de dados