Criar consultas TableAdapter parametrizadas
Publicado: agosto de 2016
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.
Criar consultas TableAdapter parametrizadas no Dataset Designer, ou durante a criação de formulários de associação de dados em um aplicativo do Windows com o parametrizar fonte de dados comando o dados menu. O parametrizar fonte de dados comando também cria controles em seu formulário para inserir os valores de parâmetro e executar a consulta.
Dica
Ao construir uma consulta parametrizada, use a notação de parâmetro específica para o banco de dados que você está codificando. Por exemplo, fontes de dados Access e OleDb usam o ponto de interrogação '?' para denotar parâmetros, portanto a cláusula WHERE teria esta aparência: WHERE City = ?.
Dica
Caixas de diálogo e comandos de menu que você vê podem diferir daqueles descritos na Ajuda, dependendo de suas configurações ativas ou edição. Para alterar suas configurações, escolha Import and Export Settings sobre o ferramentas menu. 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 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 Criar e configurar TableAdapters.
- ou -
Adicione 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 de associação de dados
Selecione um controle no formulário que já está associado a um conjunto de dados. Para obter mais informações, consulte Associar controles dos Windows Forms a dados no Visual Studio.
Sobre o dados menu, clique em Add Query.
Conclua o Pesquisar Construtor de critérios caixa de diálogo, adicionando uma cláusula WHERE com os parâmetros desejados à instrução SQL.
Para adicionar uma consulta a um formulário de associação de dados existente
Abra o formulário no Windows Forms Designer.
Clique em Add Query sobre o dados menu ou marcas inteligentes de dados.
Dica
Se Add Query não está disponível na dados menu, selecione um controle no formulário que exibe os fonte de dados você deseja adicionar a parametrização. Por exemplo, se o formulário exibe dados em um DataGridView de controle, selecione-o. Se o formulário exibe dados em controles individuais, selecione qualquer controle ligado a dados.
Selecione a tabela desejada para adicionar parametrização no tabela fonte de dados selecione área.
Digite um nome no novo nome de consulta caixa se você estiver criando uma nova consulta.
- ou -
Selecione uma consulta no nome da consulta existente caixa.
Digite uma consulta que usa parâmetros no texto da consulta caixa.
Clique em OK.
Um controle para o parâmetro de entrada e um carga botão são adicionados ao formulário em um ToolStrip controle.
Parâmetros TableAdapter podem ser atribuídos valores nulos quando você desejar consultar registros que não têm nenhum valor atual. Por exemplo, considere a consulta a seguir que possui um ShippedDate parâmetro em seu 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 ativar uma consulta aceitar valores nulos
No Dataset Designer, selecione a consulta TableAdapter que precisa aceitar valores de parâmetro nulo.
Selecione parâmetros no propriedades janela e clique nas reticências (...) para abrir o Editor de coleção de parâmetros.
Selecione o parâmetro que permite valores nulos e defina a AllowDbNull propriedade
true.