Criar consultas TableAdapter parametrizadas em aplicativos do .NET Framework

Uma consulta parametrizada retorna dados que atendem às condições de uma WHERE cláusula dentro da consulta. Por exemplo, você pode parametrizar uma lista de clientes para exibir somente clientes em uma determinada cidade adicionando WHERE City = @City ao final da instrução SQL que retorna uma lista de clientes.

Você cria consultas TableAdapter parametrizadas no Designer de Conjunto de Dados. Você também pode criá-los em um aplicativo do Windows com o comando Parametrizar Fonte de Dados no menu Dados . O comando Parametrizar Fonte de Dados cria controles no formulário em que você pode inserir os valores de parâmetro e executar a consulta.

Criar uma consulta TableAdapter parametrizada

Para criar uma consulta parametrizada no Designer de Conjunto de Dados

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

  ou

• Adicione uma consulta a um TableAdapter existente, adicionando à instrução SQL uma cláusula WHERE com os parâmetros desejados.

Para criar uma consulta parametrizada ao projetar um formulário associado a dados

1. Selecione um controle em seu formulário que já esteja associado a um conjunto de dados. Para obter mais informações, consulte Associar controles do Windows Forms a dados no Visual Studio.

2. No menu Dados , selecione Adicionar Consulta.

3. Conclua a caixa de diálogo Construtor de Critérios de Pesquisa , adicionando uma WHERE cláusula com os parâmetros desejados à instrução SQL.

Para adicionar uma consulta a um formulário associado a dados existente

1. Abra o formulário no Designer de Formulários do Windows.

2. No menu Dados , selecione Adicionar Consulta ou Marcas Inteligentes de Dados.

   Observação

   Se Adicionar Consulta não estiver disponível no menu Dados , selecione um controle no formulário que exibe a fonte de dados à qual você deseja adicionar a parametrização. Por exemplo, se o formulário exibir dados em um controle DataGridView, selecione-o. Se o formulário exibir dados em controles individuais, selecione qualquer controle associado a dados.

3. Na área Selecionar tabela de fonte de dados, selecione a tabela à qual você deseja adicionar parametrização.

4. Digite um nome na caixa Novo nome de consulta se você estiver criando uma nova consulta.

   ou

   Selecione uma consulta na caixa Nome da consulta existente .

5. Na caixa Texto de Consulta , digite uma consulta que usa parâmetros.

6. Selecione OK.

   Um controle para inserir o parâmetro e um botão Carregar é adicionado ao formulário em um ToolStrip controle.

Executar consulta para valores nulos

Os parâmetros TableAdapter podem receber valores nulos quando você deseja consultar registros que não têm valor atual. Por exemplo, considere a seguinte consulta que tem um ShippedDate parâmetro em sua WHERE cláusula:

SELECT CustomerID, OrderDate, ShippedDate
FROM Orders
WHERE (ShippedDate = @ShippedDate) OR (ShippedDate IS NULL)

Se esta fosse uma consulta em um TableAdapter, você poderia consultar todos os pedidos que não foram enviados com o seguinte código:

ordersTableAdapter.FillByShippedDate(northwindDataSet.Orders, null);

OrdersTableAdapter.FillByShippedDate(NorthwindDataSet.Orders, Nothing)

Para habilitar uma consulta a aceitar valores nulos:

1. No Designer de Conjunto de Dados, selecione a consulta do TableAdapter que precisa aceitar valores de parâmetro nulos.

2. Na janela Propriedades, selecione Parâmetros e, em seguida, selecione o botão de reticências (...) para abrir o Editor de Coleção de Parâmetros.

3. Selecione o parâmetro que permite valores nulos e defina a propriedade AllowDbNull como true.

Conteúdo relacionado

• preencha conjuntos de dados usando TableAdapters