Como: criar consultas de TableAdapter parametrizadas

Artigo
02/25/2013

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 mais informações, consulte Consultas parâmetro.

Você cria consultas TableAdapter parametrizadas no Dataset Designer ou durante a criação de formulários com associação de dados 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 mais informações, consulte Search Criteria Builder Dialog Box.

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

Observação
As caixas de diálogo e comandos de menu você vê podem diferir daquelas descritas na ajuda dependendo de suas configurações ativas ou versão.Para alterar suas configurações, escolha Import and Export Settings no menu Tools.Para mais informações, consulte Configurações de 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 mais informações, consulte Como: criar 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 ao projetar um formulário de associação de dados

Selecione um controle no formulário que já esteja associado ao um DataSet.Para mais informações, consulte Vinculando controles do Windows Forms a dados em Visual Studio.
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 mais informações, consulte Search Criteria Builder Dialog Box.