Como criar consultas TableAdapter parametrizadas

Artigo
06/10/2015

Uma consulta parametrizada retorna dados que atendem às condições de uma cláusula WHERE dentro da 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.

Crie consultas TableAdapter parametrizadas no Designer de Conjunto de Dados ou durante a criação de formulários de associação de dados em um aplicativo do Windows com o comando Parametrizar Fonte de Dados no menu Dados. O comando Parametrizar Fonte de Dados também cria controles no formulário para inserir os valores dos parâmetros e executar a consulta. Para obter mais informações, consulte Caixa de diálogo Pesquisar Construtor de Critérios.

Dica

Ao construir uma consulta parametrizada, use a notação de parâmetro específica para o banco de dados para o qual você está codificando.Por exemplo, acesso e fontes dados OleDb usam o ponto de interrogação '?' para denotar parâmetros, portanto, a cláusula WHERE seria algo como: WHERE City = ?.

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 Personalizando configurações de desenvolvimento no Visual Studio.

Criando uma consulta TableAdapter parametrizada

Para criar uma consulta parametrizada no Designer de Conjunto de Dados

Crie um novo TableAdapter, adicionando uma cláusula WHERE com os parâmetros desejados à instrução SQL. Para obter mais informações, consulte Como criar TableAdapters.

-ou-
Acrescente uma consulta a um TableAdapter existente, adicionando uma cláusula WHERE com os parâmetros desejados à instrução SQL. Para obter mais informações, consulte Como criar consultas TableAdapter.

Para criar uma consulta parametrizada durante a criação de um formulário com associação de dados

Selecione um controle no seu formulário que já esteja associado a um conjunto de dados. Para obter mais informações, consulte Associando controles dos Windows Forms a dados no Visual Studio.
No menu Dados, clique em Adicionar Consulta.
Preencha a caixa de diálogo Pesquisar Construtor de Critérios, adicionando uma cláusula WHERE com os parâmetros desejados à instrução SQL. Para obter mais informações, consulte Caixa de diálogo Pesquisar Construtor de Critérios.