Como: Adicionar uma consulta parametrizada 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 Caixa de Diálogo Construtora de Critérios de Pesquisa. 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 obter 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 demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para adicionar uma consulta a um formulário vinculado a dados existente

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

2. Clique em Add Query no menu Data ou Marcas Inteligentes de 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 vinculado a dados.

3. Selecione a tabela desejada para adicionar parametrização na área Select data source table. Para obter mais informações, consulte Caixa de Diálogo Construtora de Critérios de Pesquisa.

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 obter 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

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

Demonstra 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

Dataset Designer

Visão geral sobre fontes de dados

Outros recursos

Validando Dados