Como: criar uma consulta usando o criador de consultas

Uma consulta retorna dados de acordo com certos critérios.Para obter mais informações, consulte Consultas: Recuperando informações 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:

• Adicione 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.

• Use um parâmetro em uma condição de filtro.

  Os usuários do aplicativo podem fornecer um valor de parâmetro em tempo de execução digitando informações ou fazendo seleções na interface de 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 sejam avaliado junto, como uma única unidade separada das demais condições de filtro.

• Adicione 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.

Adicione 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 estão localizados em New York.Uma condição de filtro é a mesma que um critério de pesquisa na cláusula WHERE de uma instrução SQL tradicional.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.

Para adicionar uma condição de filtro

1. Em Designer de consulta, expanda a seção Filtro da consulta.

2. Na seção Filtro, 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.

3. Na primeira lista suspensa, selecione uma das seguintes condições:

   • Selecione Onde para retornar todas as linhas de dados compatível 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.

4. Na segunda lista suspensa, selecione a propriedade que você deseja usar para a condição de filtro.

   Por exemplo, se você desejar que a consulta retorne os pedidos de venda que têm uma data específica de pedido, a propriedade de seleção é OrderDate.

5. Na terceira lista suspensa, selecione o operador que você deseja usar.

   Por exemplo, para retornar os pedidos de venda que têm uma data de pedido feita antes de 22/9/2009 às 12:00:00 AM, selecione o operador < (menor que).

6. 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 clique 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 torna-se 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 torna-se uma lista suspensa.

   Observação
   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.

7. Na lista suspensa ou na caixa de texto que aparecem no final da condição de filtro, execute uma das seguintes etapas:

   • Se você selecionar Literal na etapa anterior, digite um valor como 22/9/2009 12:00:00 AM.

   • 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.

8. 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.

Use 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 permitem que os usuários forneçam em tempo de execução esse valor.Você também pode fornecer esse valor como um parâmetro para o método de consulta se você executar a consulta em sua lógica de negócio personalizado.

Para adicionar um parâmetro em uma consulta

1. Em Designer de consulta, expanda a seção Parâmetro.

2. 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.

3. Na caixa de texto de parâmetros, forneça um nome (por exemplo, SalesTerritory).

4. Na lista suspensa de parâmetro, selecione o tipo de dados do parâmetro (por exemplo, Cadeia de caracteres).

5. No menu Exibir, clique em Janela de Propriedades.

6. Na janela Propriedades, clique em ou desmarque a caixa de seleção de É opcional.

   • Selecione a caixa de seleção de É opcional, se você desejar 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ê desejar que a consulta para incluir 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.

7. Em Designer de consulta, expanda a seção Filtro.

8. Na seção de Filtro do designer, aponte a condição de filtro, clique no botão no final da condição de filtro e clique em Parâmetro.

9. Na lista suspensa próxima do botão, selecione o parâmetro.

Você pode habilitar os usuários a digitar ou selecionar valores de parâmetro em uma tela.Por exemplo, você pode criar uma tela que permite 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 permite a um usuário ver 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 filtro.

Para criar um grupo de filtro

1. Em Designer de consulta, expanda a seção Filtro.

2. Na seção Filtro do designer, aponte para Adicionar filtro, clique na seta para baixo e clique em Grupo.

   Um grupo de filtro é adicionado à seção Filtro.Uma nova condição de filtro é adicionada ao grupo de filtro.

Para adicionar condições de filtro a um grupo de filtro

• Execute uma das seguintes etapas:

  • Na parte inferior do grupo de filtro, clique em Adicionar filtro.

    Observação
    O botão Adicionar filtro aparece no final da linha que delineia o grupo de filtro.

  • Na seção Filtro do designer, arraste qualquer condição de filtro existente ao grupo de filtro.

Para adicionar um grupo de filtro a outro grupo de filtro

• Execute uma das seguintes etapas:

  • Na parte inferior do grupo de filtro, aponte para Adicionar filtro, clique na seta para baixo e clique em Grupo.

    Observação
    O botão Adicionar filtro aparece no final da linha que delineia o grupo de filtro.

  • Na seção Filtro do designer, arraste qualquer grupo de filtro existente ao grupo de filtro.

  O grupo de filtro filho é incluído no grupo de filtro pai.

Você pode relacionar grupos de filtro a outras condições e grupos na consulta usando um dos seguintes operadores boolianos: E, Ou, E não, Ou não.

Adicione 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

1. Em Designer de consulta, expanda a seção Classificar.

2. Na seção Classificar do designer, clique em Adicione 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.

3. Na primeira lista suspensa, selecione a propriedade que você deseja usar para o termo de classificação.Por exemplo, para classificar contatos por seu último sobrenome, selecione a propriedade LastName de entidade Contact.

4. Na segunda lista suspensa, selecione um dos seguintes itens:

   1. 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.

   2. 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.

5. 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 filtro

1. Em Designer de consulta, expanda a seção Filtro.

2. Na seção Filtro do designer, arraste uma condição de filtro ou grupo de filtro para um local que é acima ou abaixo na lista.

Para reordenar termos de classificação

1. Em Designer de consulta, expanda a seção Classificar.

2. Na seção Classificar do designer, arraste um termo de tipo para um local que é 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, assuma 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 classificadas nas datas de pedido.

Para reordenar parâmetros

1. Em Designer de consulta, expanda a seção Parâmetros.

2. Na seção Parâmetros do designer, arraste um parâmetro para um local que é 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 em maneiras que vão além dos recursos de designer de consulta, consulte Como: estende uma consulta usando código.

Consulte também

Tarefas

Como: fornecer um valor para um parâmetro de consulta

Como: estende uma consulta usando código

Como: recuperar dados de uma consulta usando código

Como: adicionar, remover e modificar uma consulta

Passo a passo: Criando uma tela

Outros recursos

Consultas: Recuperando informações de uma fonte de dados