Compartilhar via


Como adicionar uma consulta parametrizada a um aplicativo dos Windows Forms

É possível adicionar funcionalidade de pesquisa a um formulário em um aplicativo do Windows executando uma consulta parametrizada. Uma consulta parametrizada retorna dados que atendem às condições de uma cláusula WHERE. A parametrização é adicionada a uma consulta preenchendo a Caixa de diálogo Pesquisar Construtor de Critérios. Por exemplo, é possível parametrizar uma consulta para exibir somente clientes em uma determinada cidade adicionando WHERE City = @City no final da instrução SQL que retorna uma lista de clientes.

Ao preencher a Caixa de Diálogo Critérios de Pesquisa, ocorre o seguinte:

  • A consulta é adicionada ao TableAdapter associado.

  • Controles são adicionados ao formulário para usuários fornecerem qualquer valor de parâmetro necessário e um botão é adicionado para executar a consulta.

  • O código é adicionado ao evento de clique do botão que define valores de parâmetro e executa a consulta.

Dica

As caixas de diálogo e os comandos de menu que você vê podem ser diferentes dos descritos na Ajuda, dependendo da sua edição ou das configurações ativas.Para alterar as configurações, escolha Importar e Exportar Configurações no menu Ferramentas.Para obter mais informações, consulte Customizing Development Settings in Visual Studio.

Adicionar uma consulta a um formulário associado a dados existente

  1. Abra o formulário no Designer de Formulários do Windows.

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

    Dica

    Se Adicionar Consulta não estiver disponível no menu Dados, selecione um controle no formulário que exibe a fonte de dados no qual deseja adicionar a parametrização.Por exemplo, se o formulário exibir dados em um controle DataGridView, selecione-o.Se o formulário exibir dados em controles individuais, selecione qualquer controle associado a dados.

  3. Selecione a tabela desejada para adicionar parametrização na área Selecionar tabela de fonte de dados. Para obter mais informações, consulte Caixa de diálogo Pesquisar Construtor de Critérios.

  4. Digite um nome na caixa Nome da nova consulta ao criar uma nova consulta.

    -ou-

    Selecione uma consulta na caixa Nome da consulta existente.

  5. Digite uma consulta que toma os parâmetros na caixa Texto da Consulta.

  6. Clique em OK.

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

Consulte também

Tarefas

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

Instruções passo a passo: exibindo dados em um Windows Form

Como conectar a dados em um banco de dados

Como navegar em dados com o controle BindingNavigator dos Windows Forms

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

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

Referência

Janela Fontes de Dados

Conceitos

Visão geral de TableAdapter

Criando e editando conjuntos de dados tipados

Visão geral de fontes de dados

Validando dados