Partilhar via

Instruções passo a passo: criando um Windows Form para pesquisar dados

  • Artigo

Um cenário de aplicativo comum exibirá dados selecionados em um formulário. Por exemplo, você pode querer exibir os pedidos de um cliente específico ou os detalhes de um pedido específico. Nesse cenário, um usuário insere informações em um formulário e 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 apenas os dados que satisfazem os critérios inseridos pelo usuário. Este passo a passo mostra como criar uma consulta que retorna clientes de uma cidade específica, como mudar a interface do usuário para que os usuários possam inserir o nome de uma cidade e pressionar um botão para executar a consulta.

O uso de consultas parametrizadas ajuda a tornar seu aplicativo eficiente, permitindo que o banco de dados funcione melhor, filtrando registros rapidamente. Por outro lado, se você solicitar uma tabela de banco de dados inteira, transferi-la por meio da rede e usar a lógica do aplicativo para encontrar os registros que deseja, seu aplicativo pode ficar lento e perder a eficiência.

Você pode adicionar consultas parametrizadas a qualquer TableAdapter (e controles para aceitar os valores dos parâmetros e executar a consulta), usando a Caixa de diálogo Pesquisar Construtor de Critérios. Abra a caixa de diálogo, selecionando o comando Adicionar Consulta no menu Dados (ou em qualquer marca inteligente TableAdapter).

As tarefas ilustradas neste passo a passo incluem:

Pré-requisitos

Para concluir este passo a passo, você precisará de:

Criando o aplicativo do Windows

A primeira etapa é criar um Aplicativo do Windows. A atribuição de um nome ao projeto é opcional nesta etapa, mas daremos um nome a ele porque pretendemos salvá-lo posteriormente.

Para criar o novo projeto de Aplicativo do Windows

  1. No menu Arquivo, crie um novo projeto.

  2. Nomeie o projeto WindowsSearchForm.

  3. Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

    O projeto WindowsSearchForm é criado e adicionado ao Gerenciador de Soluções.

Criando a Fonte de Dados

Esta etapa cria uma fonte de dados a partir de um banco de dados usando o Assistente de Configuração de Fonte de Dados. É preciso ter acesso ao banco de dados de exemplo 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 exemplo.

Para criar a fonte de dados

  1. No menu Dados, clique em Mostrar Fontes de Dados.

  2. Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.

  3. Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.

  4. Na página Escolha a Conexão de Dados, faça o seguinte:

    • Se uma conexão de dados com o banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.

      -ou-

    • Selecione Nova Conexão para iniciar a caixa Adicionar/Modificar Conexão.

  5. Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.

  6. Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.

  7. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

  8. Selecione a tabela Clientes e clique em Concluir.

    O NorthwindDataSet é adicionado ao projeto e a tabela Clientes aparece na janela Fontes de Dados.

Criando o formulário

Você pode criar controles de associação de dados arrastando itens da janela Fontes de Dados para um formulário.

Para criar controles de associação de dados no formulário

  1. Expanda o nó Clientes na janela Fontes de Dados.

  2. Arraste o nó Clientes da janela Fontes de Dados para o seu formulário.

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

Adicionando parametrização (funcionalidade Pesquisar) à consulta

Você pode adicionar uma cláusula WHERE à consulta original usando o Caixa de diálogo Pesquisar Construtor de Critérios.

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

  1. Selecione o controle DataGridView e escolha Adicionar Consulta no menu Dados.

  2. Digite FillByCity na área Novo nome da consultaCaixa de diálogo Pesquisar Construtor de Critérios.

  3. Adicione WHERE City = @City à consulta na área Texto da Consulta.

    A consulta deve ser semelhante ao seguinte:

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

    FROM Customers

    WHERE City = @City

    Dica

    Acesso e fontes dados OleDb usam o ponto de interrogação '?' para denotar parâmetros, portanto, a cláusula WHERE seria algo como: WHERE City = ?.

  4. Clique em OK para fechar a caixa de diálogo Pesquisar Construtor de Critérios.

    Um FillByCityToolStrip é adicionado ao formulário.

Testando o aplicativo

A execução do 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 Londres na caixa de texto Cidade e clique em FillByCity.

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

Próximas etapas

Dependendo dos requisitos de aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário parametrizado. Entre algumas das melhorias que você poderia fazer nessa explicação passo a passo estão:

Consulte também

Referência

Visão geral do componente BindingSource

Visão geral do controle BindingNavigator (Windows Forms)

Conceitos

Associando controles dos Windows Forms a dados no Visual Studio

Visão geral de fontes de dados

Visão geral de TableAdapter

Outros recursos

Instruções passo a passo de dados