Usando uma consulta parametrizada em uma tela

Nesta lição, você aprenderá como usar uma consulta parametrizada em uma tela para filtrar dados.

Usando uma Consulta Parametrizada

Na última lição, você criou uma consulta para filtrar produtos com base em um parâmetro CategoryID.Em tempo de execução, esse parâmetro pode ser usado para aplicar o filtro a outra entidade que contenha um campo CategoryID.Por exemplo, você pode usar a consulta parametrizada para exibir uma lista de produtos que correspondam à categoria de um produto selecionado em uma lista na tela.

O valor do parâmetro pode ser fornecido como uma propriedade no Designer de Tela em tempo de design ou pelo usuário em tempo de execução.Neste exemplo, você atribuirá o valor em tempo de design.

Para adicionar uma consulta parametrizada a uma tela

No Gerenciador de Soluções, clique duas vezes no nó de tela CurrentProductList.
No Designer de Tela, clique no botão da barra de ferramentas Adicionar Item de Dados.

A caixa de diálogo Adicionar Item de Dados aparece.
Na caixa de diálogo Adicionar Item de Dados, clique em Consulta.
Na coluna Nome, selecione NorthwindEntitiesData.ProductsByCategorye clique em OK.

Um nó ProductsByCategoryCollection é adicionado ao painel esquerdo.
Sob o nó Parâmetros de Consulta, selecione CategoryID.
Na janela Propriedades, selecione Associação de Parâmetro e digite CurrentProducts.SelectedItem.Category.CategoryID.
No Designer de Tela, selecione o nó Layout de Linhas | Coluna de Detalhes.
Clique em Adicionar e selecione ProductsByCategory da lista suspensa.

Um novo nó DataGrid | ProductsByCategory aparece na árvore de conteúdo da tela.
Pressione F5 para executar o aplicativo e exibir os resultados.

Quando você abre a tela CurrentProductList, observe que todos os produtos que têm a mesma CategoryID que o produto selecionado no momento são exibidos na nova grade.

Visão aprofundada

Neste procedimento, você usou a consulta parametrizada que você criou na última lição para exibir uma lista de produtos.A consulta foi adicionada a uma tela existente, a tela CurrentProductList.A propriedade Valor do Parâmetro da consulta especifica o valor CategoryID do ProductCollection existente na tela e fornece o parâmetro em tempo de execução.Como resultado, uma lista de produtos que têm uma CategoryID correspondente é exibida sempre que um produto é selecionado na lista ProductCollection.