Compartilhar via


Caixa de Diálogo Construtora de Critérios de Pesquisa

Preencha essa caixa de diálogo para adicionar uma nova consulta (geralmente uma consulta parametrizada) a um formulário vinculado a dados existente em seu aplicativo do Windows. Isso inclui adicionar uma nova consulta à tabela selecionada, e adicionar controles para os usuários para entrarem com quaisquer valores de parâmetro no formulário (um botão para executar a consulta também é adicionada ao formulário).

Uma consulta parametrizada retorna dados que satisfazem às condições de uma cláusula WHERE na consulta. Por exemplo, você pode parametrizar uma lista de clientes para exibir apenas clientes em uma determinada cidade, adicionando WHERE City = @City ao final da instrução SQL que retorna uma lista de clientes. A cláusula WHERE define uma condição para ser atendida ao executar uma consulta. SELECT * FROM CustomersRetorna todos os registros a Customers da tabela, enquanto SELECT * FROM Customers WHERE City = @City retorna somente os registros em que o City coluna equivale ao valor da @City parâmetro. Adicionar uma cláusula WHERE faz sentido para o final da sua consulta.

Algumas cláusulas WHERE típicas:

SELECT * FROM Employees WHERE CompanyName like @CompanyName
SELECT * FROM Employees WHERE (LastName = @Lname) and (FirstName = @Fname)
ObservaçãoObservação

A sintaxe de espaços reservados para parâmetro varia de acordo com a fonte de dados. Este exemplo mostra espaços reservados para um fonte de dados do SQL Server (@paramname). Use espaços reservados para ? ponto de interrogação (System.Data.OleDb) e System.Data.Odbc parâmetros (WHERE CompanyName like ?).

Esta caixa de diálogo aparece quando Add Query é escolhida em uma marca inteligente ou a partir do menu Data.

Com esta caixa de diálogo, é possível:

Lista User Interface Element

  • Selecionar tabela de fonte de dados
    Selecione a tabela para adicionar a consultar a partir da lista suspensa de tabelas disponíveis em seu projeto.

  • Selecione uma consulta parametrizada para carregar os dados
    Selecione uma consulta parametrizada nova ou existente.

  • Nome de nova consulta
    Digite um nome para a nova consulta parametrizada.

  • Nome de consulta existente
    Selecione uma consulta na lista suspensa de consultas disponíveis para a tabela de dados de origem selecionada.

  • Texto da Consulta
    Insira a instrução SQL que será executada quando o botão for clicado.

    ObservaçãoObservação

    O assistente fornece o Query Builder, uma ferramenta visual para criar consultas SQL.

  • Construtor de consultas
    Abra o Query Builder, uma ferramenta visual para criar consultas SQL. Para obter mais informações, consulte Query and View Designer Tools.

Consulte também

Tarefas

Demonstra Passo a passo: Exibindo dados em um Windows Form

Como: Adicionar uma consulta parametrizada para um aplicativo do Windows Forms

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

Conceitos

Vinculação de controles do Windows Forms a dados em Visual Studio

Controles de vinculação de dados de Visual Studio

Outros recursos

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Editar dados no seu aplicativo

Validando Dados

Salvando dados