Share via


Como: Adicionar uma consulta parametrizada a um formulário em um aplicativos do Windows

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 de 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 descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

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 Adicionar consulta não está disponível o Dados menu, selecionar um controle no formulário que exibe a fonte de dados que deseja adiciona a parametrização para.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 Construtor de consultas para ajudar a criar uma consulta.Para obter mais informações, consulte Consulta and Exibir 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: Criando um formulário para pesquisar dados em um aplicativos do Windows

Demonstra Passo a passo: Exibindo dados em um formulário em um aplicativo do Windows

Como: Conectar-se a Dados em um Banco de Dados

Como: Navegar de dados com o Controlarar BindingNavigator do Windows Forms

Como: Classificar e Filtro dados ADO.NET com o componente BindingSource do Windows Forms

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

Conceitos

Visão geral do TableAdapter

Dataset Designer

Visão geral sobre fontes de dados

Referência

Janela Fontes de Dados

Outros recursos

Validando Dados