Como: Criar consultas de TableAdapter parametrizadas

Artigo
08/25/2010

Uma consulta parametrizada retorna dados que satisfazem à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.Para obter mais informações, consulte Consultas de parâmetro.

Você cria consultas de TableAdapter parametrizadas no Dataset Designer, ou durante a criação de formulários com dados vinculados em um aplicativo do Windows com o comando Parameterize Data Source no menu Data.O comando Parameterize Data Source também cria controles em seu formulário para inserir os valores dos parâmetros e executar a consulta.Para obter mais informações, consulte Caixa de Diálogo Construtora de Critérios de Pesquisa.

Observação:
Quando 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, fontes de dados OleDb e acesso usam o ponto de interrogação '? ' para denotar parâmetros, portanto, a cláusula WHERE teria esta aparência: WHERE City = ?.

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.

Criando uma Consulta de TableAdapter Parametrizada

Para criar uma consulta parametrizada no Dataset Designer

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

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

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

Selecione um controle no formulário que já esteja vinculado ao um DataSet.Para obter mais informações, consulte Exibindo visão geral de dados.
No menu Data, clique em Add Query.
Complete a caixa de diálogo Search Criteria Builder, adicionando uma cláusula WHERE com os parâmetros desejados à instrução SQL.Para obter mais informações, consulte Caixa de Diálogo Construtora de Critérios de Pesquisa.