Como: Criar consultas de TableAdapter parametrizadas

Artigo
08/01/2011

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 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 do Access e OleDb 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 descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

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 Vinculação de 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 obter mais informações, consulte Caixa de Diálogo Construtora de Critérios de Pesquisa.