Criar uma consulta básica

Artigo
02/25/2013

Esta lição mostra como criar uma LightSwitch consulta parametrizada que retorna um subconjunto de produtos.

Criar uma Consulta

Uma consulta retorna dados que atendam a um conjunto de critérios.Por exemplo, uma consulta pode retornar uma lista de clientes localizados nos Estados Unidos.Nesse exemplo, os clientes são os dados, e localizado nos Estados Unidos é o critério.

Observação
Esta lição compila o projeto MyFirstApplication que é desenvolvido nas lições Trabalhar com dados em LightSwitch (Tour guiado) e é modificado nas lições A criação de telas.Se você concluiu as lições necessárias, abra o projeto agora; caso contrário, conclua os pré-requisitos e depois retorne a esta lição.

Para criar uma consulta

Em Gerenciador de Soluções, clique duas vezes no nó OrdersByCustomer.
No painel esquerdo de selecione o designer, selecione clientes.
Clique no link Editar Consulta.

O Designer de Consulta aparece.
No Designer de Consulta, clique em Adicionar Filtro.

Uma condição de filtro é adicionada à seção Filtro.Diversas listas suspensas e uma caixa de texto aparecem próximas à condição de filtro.
Na primeira lista suspensa, selecione Onde.
Na segunda lista suspensa, selecione País.
Na terceira lista suspensa, selecione = (igual).
Na quarta lista suspensa, selecione Literal.
Digite USA na caixa de texto.
Clique Adicionar filtro novamente.
Na primeira lista suspensa, selecione ou.
Na segunda lista suspensa, selecione País.
Na terceira lista suspensa, selecione = (igual).
Na quarta lista suspensa, selecione Literal.
Na caixa de texto, digite Canadá.

Isso cria uma expressão de consulta que retorna todos os registros de clientes onde o valor do campo País seja igual ao valor literal "EUA" ou ao valor literal “Canadá”.
Clique Adicione o tipo.
Na primeira lista suspensa, selecione Cidade.

Isso classificara a consulta por Cidade em ordem alfabética.
Pressione F5 para executar o aplicativo.

Quando você abre a tela Pedidos por clientes, observe que clientes dos EUA ou do Canadá são exibidos e, que são classificados por cidade.

Visão aprofundada

Esta lição mostrou como criar uma consulta que retorna um subconjunto de clientes.A seção do filtro de consulta especificou uma condição, e a seção do tipo especificou como ordenar os resultados.Traduzindo para a linguagem natural, a consulta diz, “dá-me uma lista de todos os clientes nos EUA ou no Canadá, classificados por cidade.”

Na primeira lista suspensa do filtro, você pode selecionar onde ou onde não.Alterar a cláusula para onde não altera a consulta para retornar clientes de todos os lugares exceto dos EUA ou do Canadá.

A terceira lista suspensa de filtro contém os operadores que você pode aplicar à consulta.Por exemplo, se você tiver escolhido um campo numérico na segunda lista suspensa, você pode selecionar > (é maior que) para retornar somente os registros que excederem uma quantidade especificada.

A quarta lista suspensa do filtro contém três opções: Literal, Propriedade, e Parâmetro.Como demonstrado nesta lição, Literal significa que o critério é um valor literal.Se você tiver escolhido Propriedade, uma lista dos campos na entidade clientes seria exibida para que você possa filtrar resultados por propriedade.Por exemplo, você pode retornar todos os clientes onde Contato corresponde à ***NomeDaEmpresa***.A opção Parâmetro é descrita na lição Criando uma consulta parametrizada.

A seção do tipo de uma consulta determina a ordem em que os resultados são exibidos pela primeira vez na tela do aplicativo em execução.Um usuário pode então alterar a ordem de classificação.