Partilhar via

Passo a passo: Escrevendo consultas no Visual Basic

  • Artigo

Este passo a passo demonstra como você pode usar recursos de linguagem Visual Basic para escrever expressões de consulta LINQ (Language-Integrated Query). O passo a passo demonstra como criar consultas em uma lista de objetos Student, como executar as consultas e como modificá-las. As consultas incorporam vários recursos, incluindo inicializadores de objeto, inferência de tipo local e tipos anônimos.

Depois de concluir este passo a passo, você estará pronto para passar para as amostras e a documentação para o provedor LINQ específico em que está interessado. Os provedores LINQ incluem LINQ to SQL, LINQ to DataSet e LINQ to XML.

Criar um projeto

Para criar um projeto de aplicativo de console

  1. Inicie o Visual Studio.

  2. No menu Arquivo, aponte para Novo e clique em Projeto.

  3. Na lista Modelos instalados, clique em Visual Basic.

  4. Na lista de tipos de projeto, clique em Aplicativo de Console. Na caixa nome , digite um nome para o projeto e, em seguida, clique em OK .

    Um projeto é criado. Por padrão, ele contém uma referência a System.Core.dll. Além disso, a lista Namespaces importados na página Referências, Project Designer (Visual Basic) inclui o System.Linq namespace.

  5. Na página Compilar, Project Designer (Visual Basic), verifique se Option infer está definido como On.

Adicionar uma fonte de dados na memória

A fonte de dados para as consultas neste passo a passo é uma lista de Student objetos. Cada Student objeto contém um nome, um sobrenome, um ano de aula e uma classificação acadêmica no corpo discente.

Para adicionar a fonte de dados

  • Defina uma Student classe e crie uma lista de instâncias da classe.

    Importante

    O código necessário para definir a Student classe e criar a lista usada nos exemplos passo a passo é fornecido em Como: Criar uma lista de itens. Você pode copiá-lo de lá e colá-lo em seu projeto. O novo código substitui o código que apareceu quando você criou o projeto.

Para adicionar um novo aluno à lista de alunos

  • Siga o getStudents padrão no método para adicionar outra instância da Student classe à lista. Adicionar o aluno irá apresentá-lo aos inicializadores de objetos. Para obter mais informações, consulte Inicializadores de objeto: tipos nomeados e anônimos.

Criar uma consulta

Quando executada, a consulta adicionada nesta seção produz uma lista dos alunos cuja classificação acadêmica os coloca entre os dez primeiros. Como a consulta seleciona o objeto completo Student a cada vez, o tipo do resultado da consulta é IEnumerable(Of Student). No entanto, o tipo da consulta normalmente não é especificado nas definições de consulta. Em vez disso, o compilador usa inferência de tipo local para determinar o tipo. Para obter mais informações, consulte Inferência de tipo local. A variável de intervalo da consulta, currentStudent, serve como referência para cada Student instância na origem, studentsfornecendo acesso às propriedades de cada objeto no students.

Para criar uma consulta simples

  1. Encontre o Main lugar no método do projeto que está marcado da seguinte forma:

    ' ****Paste query and query execution code from the walkthrough,
' ****or any code of your own, here in Main.

    Copie o código a seguir e cole-o.

    Dim studentQuery = From currentStudent In students
                   Where currentStudent.Rank <= 10
                   Select currentStudent

  2. Coloque o ponteiro do mouse sobre studentQuery o código para verificar se o tipo atribuído pelo compilador é IEnumerable(Of Student).

Executar a consulta

A variável studentQuery contém a definição da consulta, não os resultados da execução da consulta. Um mecanismo típico para executar uma consulta é um For Each loop. Cada elemento na sequência retornada é acessado através da variável de iteração de loop. Para obter mais informações sobre a execução de consultas, consulte Escrevendo sua primeira consulta LINQ.

Para executar a consulta

  1. Adicione o seguinte For Each loop abaixo da consulta em seu projeto.

    For Each studentRecord In studentQuery
    Console.WriteLine(studentRecord.Last & ", " & studentRecord.First)
Next

  2. Coloque o ponteiro do mouse sobre a variável studentRecord de controle de loop para ver seu tipo de dados. O tipo de é inferido studentRecord como Student, porque studentQuery retorna uma coleção de Student instâncias.

  3. Crie e execute o aplicativo pressionando CTRL+F5. Observe os resultados na janela do console.

Modificar a consulta

É mais fácil verificar os resultados da consulta se eles estiverem em uma ordem especificada. Você pode classificar a sequência retornada com base em qualquer campo disponível.

Para ordenar os resultados

  1. Adicione a seguinte Order By cláusula entre a Where instrução e a Select instrução da consulta. A Order By cláusula ordenará os resultados alfabeticamente de A a Z, de acordo com o sobrenome de cada aluno.

    Order By currentStudent.Last Ascending

  2. Para ordenar por apelido e, em seguida, nome, adicione ambos os campos à consulta:

    Order By currentStudent.Last Ascending, currentStudent.First Ascending

    Você também pode especificar Descending para encomendar de Z para A.

  3. Crie e execute o aplicativo pressionando CTRL+F5. Observe os resultados na janela do console.

Para introduzir um identificador local

  1. Adicione o código nesta seção para introduzir um identificador local na expressão de consulta. O identificador local conterá um resultado intermediário. No exemplo a seguir, name é um identificador que contém uma concatenação dos nomes e sobrenomes do aluno. Um identificador local pode ser usado por conveniência ou pode melhorar o desempenho armazenando os resultados de uma expressão que, de outra forma, seria calculada várias vezes.

    Dim studentQuery2 =
        From currentStudent In students
        Let name = currentStudent.Last & ", " & currentStudent.First
        Where currentStudent.Year = "Senior" And currentStudent.Rank <= 10
        Order By name Ascending
        Select currentStudent

' If you see too many results, comment out the previous
' For Each loop.
For Each studentRecord In studentQuery2
    Console.WriteLine(studentRecord.Last & ", " & studentRecord.First)
Next

  2. Crie e execute o aplicativo pressionando CTRL+F5. Observe os resultados na janela do console.

Para projetar um campo na cláusula Select

  1. Adicione a consulta e For Each o loop desta seção para criar uma consulta que produza uma sequência cujos elementos diferem dos elementos na origem. No exemplo a seguir, a fonte é uma coleção de Student objetos, mas apenas um membro de cada objeto é retornado: o primeiro nome dos alunos cujo sobrenome é Garcia. Como currentStudent.First é uma cadeia de caracteres, o tipo de dados da sequência retornada por studentQuery3 é IEnumerable(Of String), uma sequência de cadeias de caracteres. Como em exemplos anteriores, a atribuição de um tipo de dados para studentQuery3 é deixada para o compilador determinar usando inferência de tipo local.

    Dim studentQuery3 = From currentStudent In students
                    Where currentStudent.Last = "Garcia"
                    Select currentStudent.First

' If you see too many results, comment out the previous
' For Each loops.
For Each studentRecord In studentQuery3
    Console.WriteLine(studentRecord)
Next

  2. Coloque o ponteiro do rato sobre studentQuery3 o código para verificar se o tipo atribuído é IEnumerable(Of String).

  3. Crie e execute o aplicativo pressionando CTRL+F5. Observe os resultados na janela do console.

Para criar um tipo anônimo na cláusula Select

  1. Adicione o código desta seção para ver como os tipos anônimos são usados em consultas. Você os usa em consultas quando deseja retornar vários campos da fonte de dados em vez de registros completos (currentStudent registros em exemplos anteriores) ou campos únicos (First na seção anterior). Em vez de definir um novo tipo nomeado que contém os campos que você deseja incluir no resultado, você especifica os campos na Select cláusula e o compilador cria um tipo anônimo com esses campos como suas propriedades. Para obter mais informações, consulte Tipos anônimos.

    O exemplo a seguir cria uma consulta que retorna o nome e a classificação de seniores cuja classificação acadêmica está entre 1 e 10, em ordem de classificação acadêmica. Neste exemplo, o tipo de deve ser inferido studentQuery4 porque a Select cláusula retorna uma instância de um tipo anônimo e um tipo anônimo não tem nome utilizável.

    Dim studentQuery4 =
        From currentStudent In students
        Where currentStudent.Year = "Senior" And currentStudent.Rank <= 10
        Order By currentStudent.Rank Ascending
        Select currentStudent.First, currentStudent.Last, currentStudent.Rank

' If you see too many results, comment out the previous
' For Each loops.
For Each studentRecord In studentQuery4
    Console.WriteLine(studentRecord.Last & ", " & studentRecord.First &
                      ":  " & studentRecord.Rank)
Next

  2. Crie e execute o aplicativo pressionando CTRL+F5. Observe os resultados na janela do console.

Exemplos adicionais

Agora que você entendeu o básico, a seguir está uma lista de exemplos adicionais para ilustrar a flexibilidade e o poder das consultas LINQ. Cada exemplo é precedido de uma breve descrição do que faz. Coloque o ponteiro do mouse sobre a variável de resultado da consulta para cada consulta para ver o tipo inferido. Use um For Each loop para produzir os resultados.

' Find all students who are seniors.
Dim q1 = From currentStudent In students
         Where currentStudent.Year = "Senior"
         Select currentStudent

' Write a For Each loop to execute the query.
For Each q In q1
    Console.WriteLine(q.First & " " & q.Last)
Next

' Find all students with a first name beginning with "C".
Dim q2 = From currentStudent In students
         Where currentStudent.First.StartsWith("C")
         Select currentStudent

' Find all top ranked seniors (rank < 40).
Dim q3 = From currentStudent In students
         Where currentStudent.Rank < 40 And currentStudent.Year = "Senior"
         Select currentStudent

' Find all seniors with a lower rank than a student who 
' is not a senior.
Dim q4 = From student1 In students, student2 In students
         Where student1.Year = "Senior" And student2.Year <> "Senior" And
               student1.Rank > student2.Rank
         Select student1
         Distinct

' Retrieve the full names of all students, sorted by last name.
Dim q5 = From currentStudent In students
         Order By currentStudent.Last
         Select Name = currentStudent.First & " " & currentStudent.Last

' Determine how many students are ranked in the top 20.
Dim q6 = Aggregate currentStudent In students
         Where currentStudent.Rank <= 20
         Into Count()

' Count the number of different last names in the group of students.
Dim q7 = Aggregate currentStudent In students
         Select currentStudent.Last
         Distinct
         Into Count()

' Create a list box to show the last names of students.
Dim lb As New System.Windows.Forms.ListBox
Dim q8 = From currentStudent In students
         Order By currentStudent.Last
         Select currentStudent.Last Distinct

For Each nextName As String In q8
    lb.Items.Add(nextName)
Next

' Find every process that has a lowercase "h", "l", or "d" in its name.
Dim letters() As String = {"h", "l", "d"}
Dim q9 = From proc In System.Diagnostics.Process.GetProcesses,
         letter In letters
         Where proc.ProcessName.Contains(letter)
         Select proc

For Each proc In q9
    Console.WriteLine(proc.ProcessName & ", " & proc.WorkingSet64)
Next

Informações Adicionais

Depois de se familiarizar com os conceitos básicos de trabalhar com consultas, você estará pronto para ler a documentação e os exemplos para o tipo específico de provedor LINQ em que está interessado:

Consulte também