Compartilhar via


Demonstra Passo a passo: Criar um Windows Form para pesquisar dados

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 Caixa de Diálogo Construtora de Critérios de Pesquisa. 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 Criando Aplicativos Baseados no Windows.

    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 Caixa de Diálogo Construtora de Critérios de Pesquisa.

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 Caixa de Diálogo Construtora de Critérios de Pesquisa.

  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 do Access e OleDb usam o ponto de interrogação '?' para denotar parâmetros, portanto, 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 BindingNavigator Control (Windows Forms)

Conceitos

O que há de novo no desenvolvimento de aplicativos de dados

Vinculação de 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 sobre Dados