Como: adicionar uma consulta com parâmetros para um aplicativo do Windows Forms

A adição da funcionalidade de pesquisa a um formulário em um aplicativo do Windows pode ser realizada ao executar uma consulta parametrizada.Uma consulta parametrizada retorna dados que satisfazem às condições de uma cláusula WHERE.Você adiciona parametrização a uma consulta completando o Search Criteria Builder Dialog Box.Por exemplo, você pode parametrizar uma consulta para exibir apenas clientes em uma determinada cidade, adicionando WHERE City = @City ao final da instrução SQL que retorna uma lista de clientes.Para mais informações, consulte Consultas parâmetro.

Completar a Search Criteria Dialog Box faz o seguinte:

• A consulta é adicionada à TableAdapter associada.

• Controles são adicionados ao formulário para que os usuários possam fornecer os valores de parâmetros necessários, e um botão é adicionado para executar a consulta.

• Código é adicionado ao evento de clique do botão, que defini valores de parâmetro e executa a consulta.

Observação
As caixas de diálogo e comandos de menu você vê podem diferir daquelas descritas na ajuda dependendo de suas configurações ativas ou versão.Para alterar suas configurações, escolha Import and Export Settings no menu Tools.Para mais informações, consulte Configurações de Visual Studio.

Para adicionar uma consulta a um formulário de associação de dados existente

1. Abra o formulário no Windows Forms Designer.

2. Clique Adicionar Consulta no menu ou em Marcas inteligentes de dadosde Dados .

   Observação
   Se Add Query não está disponível no menu Data, selecione um controle no formulário que exibe a fonte de dados para a qual você deseja adicionar a parametrização.Por exemplo, se o formulário exibe dados em um controle DataGridView, selecione-o.Se o formulário exibe dados em controles individuais, selecione qualquer controle associado a dados.

3. Selecione a tabela desejada para adicionar parametrização na área Select data source table.Para mais informações, consulte Search Criteria Builder Dialog Box.

4. Digite um nome na caixa New query name se você estiver criando uma nova consulta.

   -  ou  -

   Selecione uma consulta na caixa Existing query name.

5. Digite uma consulta que usa parâmetros na caixa Query Text.

   Dica
   Use o Query Builder para ajudar a criar uma consulta.Para mais informações, consulte Query and View Designer Tools.

6. Clique em OK.

   Um controle para inserir o parâmetro e um botão Load são adicionados ao formulário em um controle ToolStrip.

Consulte também

Tarefas

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

Passo a passo: Exibindo dados em um Windows Form

Como: conectar-se a dados em um banco de dados.

Como: navegar em dados com o controle BindingNavigator do Windows Forms

Como: classificar e filtrar dados ADO.NET com o componente BindingSource do Windows Forms

Como: criar uma tabela de pesquisa com o componente BindingSource do Windows Forms

Referência

Janela fontes de dados

Conceitos

Visão geral do TableAdapter

Criando e editando conjuntos de dados tipados

Visão geral sobre fontes de dados

Validação de dados