Como criar uma consulta usando o Designer de Consulta
Uma consulta retorna dados de acordo com certos critérios. Para obter mais informações, consulte Consultas: recuperando informações a partir de uma fonte de dados. Use uma consulta para exibir informações em uma tela. Você também pode usar os resultados de uma consulta em sua lógica de negócio personalizado.
Para começar, adicionar uma consulta ao projeto. Para obter mais informações, consulte Como adicionar, remover e modificar uma consulta. A consulta é automaticamente aberta no designer de consulta. No designer de consulta, execute qualquer uma das seguintes tarefas para criar uma consulta:
Adicionar condições de filtro.
Uma condição de filtro descreve um teste que cada linha de dados deve passar para ser incluída nos resultados.
Usar um parâmetro em uma condição de filtro.
Os usuários do aplicativo podem fornecer um valor de parâmetro no tempo de execução digitando informações ou fazendo seleções na interface do usuário (UI, em inglês).
Agrupar condições de filtro.
Use grupos de filtro para garantir que um conjunto de condições de filtro seja avaliado junto como uma única unidade separada das demais condições de filtro.
Adicionar termos de classificação.
Termos de classificação permitem que você defina a ordem de classificação inicial das linhas de dados que são retornadas por uma consulta.
Reordenar condições de filtro, filtrar grupos, termos de classificação e parâmetros.
Você pode alterar a ordem na qual condições de filtro, grupos de filtro, termos de classificação e parâmetros são avaliados na consulta.
Adicionar condições de filtro
As condições de filtro especificam as linhas de dados as quais você deseja que sejam retornadas pela consulta. Por exemplo, você pode adicionar uma condição de filtro que apenas retorne clientes que estejam localizados em Nova York. Uma condição de filtro é equivalente a um critério de pesquisa na cláusula WHERE de uma instrução tradicional SQL. As condições de filtro contêm uma propriedade de seleção, um operador, um tipo de comparação e um valor de comparação. As condições de filtragem são separadas por operadores boolianos.
A ilustração a seguir mostra as partes de uma condição de filtro.
.png "Condições de filtro em uma consulta")
Para adicionar uma condição de filtro
No Designer de Consulta, expanda a seção Filtrar da consulta.
Na seção Filtrar, clique em Adicionar Filtro.
Uma condição de filtro é adicionada à seção Filtrar. Diversas listas suspensas e uma caixa de texto aparecem próximas à condição de filtro.
Na primeira lista suspensa, selecione uma das seguintes condições:
Selecione Onde para retornar todas as linhas de dados compatíveis com o resto da condição de filtro.
Selecione Onde Não para retornar linhas de dados que não estão de acordo com o restante de condição de filtro.
Na segunda lista suspensa, selecione a propriedade que você deseja usar para a condição de filtro.
Por exemplo, se você quiser que a consulta retorne os pedidos de venda que tenha uma data específica de pedido, a propriedade de seleção é OrderDate.
Na terceira lista suspensa, selecione o operador que você deseja usar.
Por exemplo, para retornar os pedidos de venda que tenham uma data de pedido feita antes de 22/09/2009 às 00h00min00, selecione o operador < (menor que).
Adicione um valor de comparação. Para fazer isso, clique no botão próximo à caixa de texto que aparece no final da condição de filtro e em um dos dois seguintes botões:
Clique em Literal para digitar o valor que você deseja usar como o valor de comparação.
Clique em Propriedade para usar uma propriedade como o valor de comparação.
Se você selecionar esta opção, a caixa de texto se tornará uma lista suspensa.
Clique em Parâmetro para adicionar um parâmetro como um valor de comparação.
Se você selecionar esta opção, a caixa de texto se tornará uma lista suspensa.
Dica
Para certos tipos de campos, como campos DateTime, você pode clicar em Global para usar valores relativos como Agora, Hoje ou Início da Semana.
Na lista suspensa ou na caixa de texto que aparece ao final da condição de filtro, execute uma das seguintes etapas:
Se você selecionar Literal na etapa anterior, digite um valor como 22/09/2009 00h00min00.
Se você selecionar Propriedade na etapa anterior, selecione ou digite o nome da propriedade.
Se você selecionar Parâmetro na etapa anterior, selecione um parâmetro.
Repita as etapas 2-7 para adicionar quantas condições de filtragem para a consulta você quiser.
Você pode relacionar uma condição de filtro a outras condições de filtro usando um dos seguintes operadores boolianos: E, Ou, E Não, Ou Não.
Usar um parâmetro em uma condição de filtro
Você pode adicionar um parâmetro como um valor de comparação em uma condição de filtro. Você pode criar as telas que permitam que os usuários forneçam esse valor em tempo de execução. Você também poderá fornecer esse valor como um parâmetro para o método de consulta se executar a consulta em sua lógica de negócio personalizada.
Para adicionar um parâmetro a uma consulta
No Designer de Consulta, expanda a seção Parâmetro.
Na seção Parâmetro do designer, clique em Adicionar Parâmetro.
Um parâmetro é adicionado à seção Parâmetro. Uma caixa de texto e uma lista suspensa aparecem como parte do parâmetro.
Na caixa de texto do parâmetro, forneça um nome (por exemplo, SalesTerritory).
Na lista suspensa do parâmetro, selecione o tipo de dados do parâmetro (por exemplo, Cadeia de Caracteres).
No menu Exibir, clique em Janela de Propriedades.
Na janela Propriedades, marque ou desmarque a caixa de seleção É opcional.
Marque a caixa de seleção É opcional, se você quiser que a consulta exclua as condições de filtro que usam o parâmetro quando o valor do parâmetro for nulo.
Desmarque a caixa de seleção É opcional, se você quiser que a consulta inclua sempre as condições de filtro que usam o parâmetro mesmo quando o valor do parâmetro for nulo. Se o valor do parâmetro for nulo, o valor nulo será usado como o valor de comparação ao avaliar a condição de filtro.
No Designer de Consulta, expanda a seção Filtrar.
Na seção Filtrar do designer, aponte a condição de filtro, clique no botão ao final da condição de filtro e clique em Parâmetro.
Na lista suspensa próxima do botão, selecione o parâmetro.
Você pode permitir que os usuários digitem ou selecionem valores de parâmetro em uma tela. Por exemplo, você pode criar uma tela que permita que um usuário veja uma lista de clientes selecionando um território de vendas.
Como alternativa, você pode associar o parâmetro a propriedades de outras listas. Por exemplo, você pode criar uma tela que permita a um usuário exibir uma lista de pedidos de venda selecionando um cliente. Para obter informações sobre como permitir que usuários forneçam um valor de parâmetro em uma tela, consulte Como fornecer um valor para um parâmetro de consulta.
Agrupar condições de filtro
Você pode agrupar condições de filtro de modo que sejam avaliadas como uma unidade. Agrupar condições de filtro é como colocar parênteses em torno das expressões em uma instrução SQL. As expressões entre parênteses são avaliadas antes de outras expressões na instrução.
A ilustração a seguir mostra dois grupos de filtros.
.png "Grupos de filtro em uma consulta")
Para criar um grupo de filtro
No Designer de Consulta, expanda a seção Filtrar.
Na seção Filtrar do designer, aponte para Adicionar Filtro, clique na seta para baixo e clique em Grupo.
Um grupo de filtros é adicionado à seção Filtrar. Uma nova condição de filtro é adicionada ao grupo de filtros.
Para adicionar condições de filtro a um grupo de filtros
Execute uma das seguintes etapas:
Na parte inferior do grupo de filtros, clique em Adicionar Filtro.
Dica
O botão Adicionar Filtro aparece ao final da linha que delineia o grupo de filtros.
Na seção Filtrar do designer, arraste qualquer condição de filtro existente ao grupo de filtros.
Para adicionar um grupo de filtros a outro grupo de filtros
Execute uma das seguintes etapas:
Na parte inferior do grupo de filtros, aponte para Adicionar Filtro, clique na seta para baixo e clique em Grupo.
Dica
O botão Adicionar Filtro aparece ao final da linha que delineia o grupo de filtros.
Na seção Filtrar do designer, arraste qualquer grupo de filtros existente para o grupo de filtros.
O grupo de filtros filho é incluído no grupo de filtros pai.
Você pode relacionar grupos de filtros a outras condições e grupos na consulta usando um dos seguintes operadores boolianos: E, Ou, E Não, Ou Não.
Adicionar termos de classificação
Você pode especificar a ordem em que os resultados de uma consulta aparecem adicionando um ou mais termos de classificação. Um termo de classificação é semelhante a uma coluna na cláusula ORDER BY de uma instrução SQL tradicional.
Para classificar os resultados de uma consulta
No Designer de Consulta, expanda a seção Ordenar.
Na seção Ordenar do designer, clique em Adicionar Classificação.
Um termo de classificação é adicionado à lista de condições de classificação. Duas listas suspensas aparecem próximas ao termo de classificação.
Na primeira lista suspensa, selecione a propriedade que você deseja usar para o termo de classificação. Por exemplo, para classificar contatos por seu sobrenome, selecione a propriedade LastName da entidade Contact.
Na segunda lista suspensa, selecione um dos seguintes itens:
Selecione Crescente para classificar resultados do menor para o maior. Por exemplo, os sobrenomes que começam com a letra A aparecem primeiro. Sobrenomes que começam com a letra Z aparecem por último.
Selecione Decrescente para classificar resultados do maior para o menor. Por exemplo, os sobrenomes que começam com a letra Z aparecem primeiro. Sobrenomes que começam com a letra A aparecem por último.
Repita as etapas 2-4 para adicionar quantos termos de classificação para a consulta você quiser.
Termos de classificação apenas definem a ordem de classificação inicial de linhas de dados que aparecem em uma tela. Os usuários podem exibir linhas de dados em uma ordem diferente para interagir com a tela.
Reordenar condições de filtro, filtrar grupos, termos de classificação e parâmetros
Você pode alterar a ordem na qual condições de filtro, grupos de filtro, termos de classificação e parâmetros são avaliados na consulta.
Para reordenar condições de filtro e grupos de filtros
No Designer de Consulta, expanda a seção Filtrar.
Na seção Filtrar do designer, arraste uma condição de filtro ou grupo de filtros para um local que esteja acima ou abaixo na lista.
Para reordenar termos de classificação
No Designer de Consulta, expanda a seção Ordenar.
Na seção Ordenar do designer, arraste um termo de classificação para um local que esteja acima ou abaixo na lista.
Alterar a ordem dos termos de classificação afeta como os dados são classificados em resultados de consulta. Por exemplo, pressuponha dois termos de classificação, um classifica os dados por SalesTerritory e o outro classifica por OrderDate. Nesse exemplo, os pedidos poderiam ser classificados por SalesTerritory primeiro. Em seguida, os pedidos em cada grupo de SalesTerritory poderiam ser classificados nas datas de pedido.
Para reordenar parâmetros
No Designer de Consulta, expanda a seção Parâmetros.
Na seção Parâmetros do designer, arraste um parâmetro para um local acima ou abaixo na lista.
Próximas etapas
Para saber como usar uma consulta em uma tela, consulte Como criar uma tela do Silverlight.
Para saber como estender uma consulta de maneira que vá além dos recursos de designer de consulta, consulte Como estender uma consulta usando código.
Consulte também
Tarefas
Como fornecer um valor para um parâmetro de consulta
Como estender uma consulta usando código
Como recuperar dados a partir de uma consulta usando código
Como adicionar, remover e modificar uma consulta
Instruções passo a passo: criando uma tela do Silverlight no LightSwitch
Outros recursos
Consultas: recuperando informações a partir de uma fonte de dados