Criando uma consulta parametrizada

Artigo
02/25/2013

Esta lição mostra como criar uma consulta parametrizada em um aplicativo LightSwitch.

Criar uma consulta parametrizada

Uma consulta parametrizada faz uso de um ou mais valores que são determinadas em tempo de execução para determinar quais dados são retornados.Por exemplo, uma consulta parametrizada pode retornar uma lista de produtos que se enquadram em uma determinada categoria.Nesse caso, um parâmetro determina qual categoria usar; pode ser baseado em um valor que é determinado através de programação ou mais comumente em um valor inserido pelo usuário.

Para criar uma consulta parametrizada

No Gerenciador de Soluções, selecione o nó Produtos.
No menu Projeto, clique em Adicionar Consulta.

O Editor de consulta aparece.
No janela Propriedades, no campo Nome, digite ProductsByCategory.
No Designer de Consulta, clique em Adicionar Filtro.
Na primeira lista suspensa, selecione Onde.
Na segunda lista suspensa, selecione Category.CategoryID.
Na terceira lista suspensa, selecione = (igual).
Na quarta lista suspensa, selecione Parâmetro.
Na última lista suspensa, clique em Adicionar Novo.

Um novo parâmetro chamado CategoryID, do tipo Integer é adicionado para a seção Parâmetros do Editor de consulta.

Visão aprofundada

Esta lição mostrou como criar uma consulta parametrizada que retorna um subconjunto de produtos.Tempo de execução, uma caixa CategoryID é fornecida para que um usuário possa especificar um valor numérico para o parâmetro CategoryID.Por exemplo, se o usuário especifica 1 na caixa, serão retornados todos os produtos na categoria Bebidas.Se o usuário especifica 2, Condimentos serão retornados.

O valor do parâmetro pode ser digitado em uma caixa de texto ou selecionado em uma lista.Também pode ser fornecido por outra entidade em uma tela.Quando um produto é selecionado em uma tela, você pode usar seu CategoryID como um parâmetro para retornar todos os outros produtos na mesma categoria.