Wprowadzenie do LINQ w Visual Basic

Language-Integrated Query (LINQ) umożliwia wykonywanie zapytań do Visual Basic i dostarcza proste oraz wydajne narzędzia podczas pracy z danymi wszelkiego rodzaju.Zamiast wysyłania kwerendy do bazy danych w celu przetworzenia lub posługiwanie się różną składnią kwerendy dla każdego typu danych, które przeszukujesz, LINQ wprowadza kwerendy jako część języka Visual Basic.Używa zunifikowaną składnię, bez względu na typ danych.

LINQ umożliwia zapytania o dane z bazy danych programu SQL Server, XML, tablic i kolekcji w pamięci, zestawów danych ADO.NET lub innych danych zdalnych lub z lokalnego źródła obsługiwanych przez LINQ.Możesz robić to wszystko stosując typowe elementy języka Visual Basic.Ponieważ zapytania są napisane w Visual Basic języku, wyniki zapytania są zwracane jako obiekty jednoznaczne.Obiekty te obsługują IntelliSense, który umożliwia szybsze pisanie kodu i wyłapywanie błędów w zapytaniach w czasie kompilacji, w przeciwieństwie do czasu uruchomienia.Zapytania LINQ można również używać jako źródło dodatkowych kwerend w uściślaniu wyników.Mogą być również powiązane z kontrolkami, tak aby użytkownicy mogli łatwo podglądać i modyfikować wyniki zapytania.

Na przykład poniższy kod pokazuje zapytanie LINQ, które zwraca listę klientów z kolekcji i grupuje ich na podstawie lokalizacji.

' Obtain a list of customers. 
Dim customers As List(Of Customer) = GetCustomers()

' Return customers that are grouped based on country. 
Dim countries = From cust In customers
                Order By cust.Country, cust.City
                Group By CountryName = cust.Country
                Into CustomersInCountry = Group, Count()
                Order By CountryName

' Output the results. 
For Each country In countries
    Debug.WriteLine(country.CountryName & " count=" & country.Count)

    For Each customer In country.CustomersInCountry
        Debug.WriteLine("   " & customer.CompanyName & "  " & customer.City)
    Next 
Next 

' Output: 
'   Canada count=2 
'      Contoso, Ltd  Halifax 
'      Fabrikam, Inc.  Vancouver 
'   United States count=1 
'      Margie's Travel  Redmond

W tym temacie znajdziesz informacje o następujących obszarach:

• Uruchamianie przykładów

• Dostawcy LINQ

• Struktura zapytania LINQ

• Operatory zapytań LINQ Visual Basic

• Połączenie z bazą danych za pomocą programu LINQ to SQL

• Funkcje Visual Basic obsługujące LINQ

• Wykonanie odroczonych i natychmiastowych zapytań

• XML w języku Visual Basic

• Zasoby pokrewne

• Tematy Jak to zrobić oraz instruktaże

Uruchamianie przykładów

Aby uruchomić przykłady we wstępie i w rozdziale „Struktura zapytania LINQ”, zawrzyj następujący kod, który zwróci listę klientów i zamówień.

' Return a list of customers. 
Private Function GetCustomers() As List(Of Customer)
    Return New List(Of Customer) From
        {
            New Customer With {.CustomerID = 1, .CompanyName = "Contoso, Ltd", .City = "Halifax", .Country = "Canada"},
            New Customer With {.CustomerID = 2, .CompanyName = "Margie's Travel", .City = "Redmond", .Country = "United States"},
            New Customer With {.CustomerID = 3, .CompanyName = "Fabrikam, Inc.", .City = "Vancouver", .Country = "Canada"}
        }
End Function 

' Return a list of orders. 
Private Function GetOrders() As List(Of Order)
    Return New List(Of Order) From
        {
            New Order With {.CustomerID = 1, .Amount = "200.00"},
            New Order With {.CustomerID = 3, .Amount = "600.00"},
            New Order With {.CustomerID = 1, .Amount = "300.00"},
            New Order With {.CustomerID = 2, .Amount = "100.00"},
            New Order With {.CustomerID = 3, .Amount = "800.00"}
        }
End Function 

' Customer Class. 
Private Class Customer
    Public Property CustomerID As Integer 
    Public Property CompanyName As String 
    Public Property City As String 
    Public Property Country As String 
End Class 

' Order Class. 
Private Class Order
    Public Property CustomerID As Integer 
    Public Property Amount As Decimal 
End Class

Dostawcy LINQ

dostawca LINQ mapuje Visual Basic zapytania LINQ w źródle danych, którego dotyczy kwerenda.Kiedy piszesz zapytanie LINQ, dostawca tłumaczy to zapytanie na polecenia, które źródło danych będzie w stanie wykonać.Dostawca konwertuje również dane ze źródła do obiektów, które składają się na wynik Twojego zapytania.Na koniec konwertuje obiekty do danych podczas wysyłania aktualizacji do źródła danych.

Visual Basic, która obejmuje następujących dostawców LINQ.

Struktura zapytania LINQ

Kwerenda LINQ, często nazywana wyrażenie kwerendy, składa się z kombinacji zdań zapytania, które identyfikują źródła danych i zmiennych iteracji dla zapytania.W wyrażeniu zapytania można również dołączyć instrukcje dotyczące sortowania, filtrowania, grupowania i łączenie lub obliczeń do stosowania w źródle danych.Składnia wyrażenia kwerendy przypomina składnię SQL; w związku z tym można znaleźć wiele podobieństw składni.

Wyrażenie zapytania zaczyna się od From zdania.Ta klauzula identyfikuje dane źródłowe dla zapytania i zmienne wykorzystywane do odwołania dla każdego elementu danych źródłowych osobno.Te zmienne nazywane są zmiennymi zakresu lub zmiennymi iteracji.Klauzula From jest wymagana dla zapytania, z wyjątkiem zapytań Aggregate, gdzie klauzula From jest opcjonalna.Po tym jak zakres i źródła zapytania zostaną zidentyfikowane w From lub Aggregate zdań, może zawierać dowolną kombinację zdań zapytania w celu doprecyzowania zapytania.Szczegółowe informacje dotyczące klauzul kwerendy – zobacz: Operatory zapytań LINQ Visual Basic w dalszej części tego tematu.Na przykład poniższe zapytanie identyfikuje kolekcję źródłową danych klienta jako zmienną customers i zmienną iteracji o nazwie cust.

Dim customers = GetCustomers()

Dim queryResults = From cust In customers

For Each result In queryResults
    Debug.WriteLine(result.CompanyName & "  " & result.Country)
Next 

' Output: 
'   Contoso, Ltd  Canada 
'   Margie's Travel  United States 
'   Fabrikam, Inc.  Canada

Ten przykład jest prawidłowym zapytaniem, jednak zapytanie staje się mocniejsze po dodaniu większej liczby klauzul zapytania, aby udoskonalić wynik.Na przykład można dodać klauzulę Where, aby filtrować wynik według co najmniej jednej wartości.Wyrażenia kwerendy są jednowierszowym kodem; klauzule dodatkowe kwerendy można dołączyć tylko na końcu kwerendy.Możesz rozbić zapytanie w wielu wierszach tekstu, aby polepszyć czytelność, ozywając znaku kontynuacji wiersza, czyli podkreślnika (_).Poniższy przykład kodu pokazuje przykład zapytania, które obejmuje klauzulę Where.

Dim queryResults = From cust In customers
                   Where cust.Country = "Canada"

Innym potęrżnym zdaniem zapytania jest Select zdanie, które pozwala zwrócić tylko wybrane pola ze źródła danych.Zapytania LINQ zwracają przeliczalne kolekcje obiektów silnie typizowanych.Zapytanie może zwracać kolekcją typów anonimowych lub nazwanych.Można również użyć klauzuli Select, aby zwrócić tylko jedno pole ze źródła danych.Kiedy to zrobisz, typ zwracanej kolekcji jest nowym typem tego pojedynczego pola.Można również użyć klauzuli Select, aby zwrócić wiele pól ze źródła danych.Kiedy to zrobisz, typ zwracanej kolekcji jest nowym typem anonimowym.Możesz również dopasować zwrócone przez zapytanie pola do pól określonego typu nazwy.Poniższy przykład kodu pokazuje wyrażenie zapytania, które zwraca kolekcję typów anonimowe, mających członków wypełnionych danymi z wybranych pól ze źródła danych.

Dim queryResults = From cust In customers
               Where cust.Country = "Canada" 
               Select cust.CompanyName, cust.Country

Zapytania LINQ można również używać do łączenia wielu źródeł danych i zwrócenia pojedynczego wyniku.Może to zostać zrobione z jedną lub większą ilością klauzul From lub z wykorzystaniem Join lub klauzul zapytania Group Join.Poniższy przykład kodu pokazuje wyrażenie zapytania, które łączy dane klienta i zamówienia i zwraca kolekcję typów anonimowych, zawierające dane klienta i zamówienia.

Dim customers = GetCustomers()
Dim orders = GetOrders()

Dim queryResults = From cust In customers, ord In orders
           Where cust.CustomerID = ord.CustomerID
           Select cust, ord

For Each result In queryResults
    Debug.WriteLine(result.ord.Amount & "  " & result.ord.CustomerID & "  " & result.cust.CompanyName)
Next 

' Output: 
'   200.00  1  Contoso, Ltd 
'   300.00  1  Contoso, Ltd 
'   100.00  2  Margie's Travel 
'   600.00  3  Fabrikam, Inc. 
'   800.00  3  Fabrikam, Inc.

Można użyć klauzuli Group Join, aby utworzyć hierarchiczny wynik zapytania, który zawiera kolekcję obiektów klienta.Każdy obiekt klienta ma właściwość, która zawiera zbiór wszystkich zamówień tego klienta.Poniższy przykład kodu pokazuje wyrażenie zapytania, które łączy dane klienta i zamówienia w postaci wyniku hierarchicznego i zwraca kolekcję typów anonimowych.Zapytanie zwraca typ, który zawiera właściwość CustomerOrders , która zawiera kolekcję danych zamówienia dla klienta.Zawiera również właściwość OrderTotal, która zawiera łączną sumę dla wszystkich zamówień dla tego klienta. (To zapytanie jest równoważne z LEFT OUTER JOIN.)

Dim customers = GetCustomers()
Dim orders = GetOrders()

Dim queryResults = From cust In customers
                   Group Join ord In orders On
                     cust.CustomerID Equals ord.CustomerID
                     Into CustomerOrders = Group,
                          OrderTotal = Sum(ord.Amount)
                   Select cust.CompanyName, cust.CustomerID,
                          CustomerOrders, OrderTotal

For Each result In queryResults
    Debug.WriteLine(result.OrderTotal & "  " & result.CustomerID & "  " & result.CompanyName)
    For Each ordResult In result.CustomerOrders
        Debug.WriteLine("   " & ordResult.Amount)
    Next 
Next 

' Output: 
'   500.00  1  Contoso, Ltd 
'      200.00 
'      300.00 
'   100.00  2  Margie's Travel 
'      100.00 
'   1400.00  3  Fabrikam, Inc. 
'      600.00 
'      800.00

Istnieje kilka dodatkowych operatorów zapytań LINQ, których można użyć to utworzenia mocnych wyrażeń zapytania.Następna sekcji tego tematu omawia różne klauzule zapytań, które można uwzględnić w wyrażeniu zapytania.Szczegółowe informacje o klauzuli kwerendy Visual Basic – zobacz: Zapytania (Visual Basic).

Operatory zapytań LINQ Visual Basic

Klasy w obszarze nazwy System.Linq i inne obszary nazw obsługi zapytań LINQ to metody, które można wywołać, aby utworzyć i dostosować zapytania oparte na potrzebach aplikacji.Visual Basic zawiera słowa kluczowe dla najbardziej typowych klauzul zapytania, jak opisano w poniższej tabeli..

' Returns the company name for all customers for which 
' the Country is equal to "Canada". 
Dim names = From cust In customers
            Where cust.Country = "Canada" 
            Select cust.CompanyName

' Returns the company name and ID value for each 
' customer as a collection of a new anonymous type. 
Dim customerList = From cust In customers
                   Select cust.CompanyName, cust.CustomerID

' Returns all product names for which the Category of 
' the product is "Beverages". 
Dim names = From product In products
            Where product.Category = "Beverages" 
            Select product.Name

' Returns a list of books sorted by price in  
' ascending order. 
Dim titlesAscendingPrice = From b In books
                           Order By b.price

' Returns a combined collection of all of the  
' processes currently running and a descriptive 
' name for the process taken from a list of  
' descriptive names. 
Dim processes = From proc In Process.GetProcesses
                Join desc In processDescriptions
                  On proc.ProcessName Equals desc.ProcessName
                Select proc.ProcessName, proc.Id, desc.Description

' Returns a list of orders grouped by the order date 
' and sorted in ascending order by the order date. 
Dim orderList = From order In orders
                Order By order.OrderDate
                Group By OrderDate = order.OrderDate
                Into OrdersByDate = Group

' Returns a combined collection of customers and 
' customer orders. 
Dim customerList = From cust In customers
                   Group Join ord In orders On
                     cust.CustomerID Equals ord.CustomerID
                   Into CustomerOrders = Group,
                        TotalOfOrders = Sum(ord.Amount)
                   Select cust.CompanyName, cust.CustomerID,
                          CustomerOrders, TotalOfOrders

' Returns the sum of all order amounts. 
Dim orderTotal = Aggregate order In orders
                 Into Sum(order.Amount)

' Returns the customer company name and largest  
' order amount for each customer. 
Dim customerMax = From cust In customers
                  Aggregate order In cust.Orders
                  Into MaxOrder = Max(order.Amount)
                  Select cust.CompanyName, MaxOrder

' Returns a list of products with a calculation of 
' a ten percent discount. 
Dim discountedProducts = From prod In products
                         Let Discount = prod.UnitPrice * 0.1
                         Where Discount >= 50
                         Select prod.Name, prod.UnitPrice, Discount

' Returns a list of cities with no duplicate entries. 
Dim cities = From item In customers
             Select item.City
             Distinct

' Returns a list of customers. The first 10 customers 
' are ignored and the remaining customers are 
' returned. 
Dim customerList = From cust In customers
                   Skip 10

' Returns a list of customers. The query ignores all 
' customers until the first customer for whom 
' IsSubscriber returns false. That customer and all 
' remaining customers are returned. 
Dim customerList = From cust In customers
                   Skip While IsSubscriber(cust)

' Returns the first 10 customers. 
Dim customerList = From cust In customers
                   Take 10

' Returns a list of customers. The query returns 
' customers until the first customer for whom  
' HasOrders returns false. That customer and all  
' remaining customers are ignored. 
Dim customersWithOrders = From cust In customers
                          Order By cust.Orders.Count Descending
                          Take While HasOrders(cust)

Szczegółowe informacje o klauzuli kwerendy Visual Basic – zobacz: Zapytania (Visual Basic).

Można użyć dodatkowych funkcji zapytania LINQ, wywołując elementy wyliczalnych lub odpytywalnych typów dostarczonych przez LINQ.Te dodatkowe możliwości mogą zostać wykorzystane poprzez wywołanie konkretnego operatora zapytania dla wyniku wyrażenia zapytania.Na przykład następujący kod wykorzystuje metodę Union``1, aby połączyć dwa wyniki zapytań w jeden wynik zapytania.Używa metody ToList``1, aby zwrócić wynik kwerendy w postaci listy ogólnej.

Public Function GetAllCustomers() As List(Of Customer)
    Dim customers1 = From cust In domesticCustomers
    Dim customers2 = From cust In internationalCustomers

    Dim customerList = customers1.Union(customers2)

    Return customerList.ToList()
End Function

Szczegółowe informacje o dodatkowych możliwościach LINQ – zobacz: Standardowe operatory zapytań — Omówienie.

Połączenie z bazą danych za pomocą programu LINQ to SQL

W Visual Basic możesz zidentyfikować obiekty bazy danych programu SQL Server, takie jak tabele, widoki i procedury przechowywania, do których chcesz uzyskać dostęp za pomocą LINQ do pliku SQL.Plik LINQ to SQL ma rozszerzenie .dbml.

Kiedy posiadasz prawidłowe połączenie z bazą danych SQL Server, możesz dodać element szablonu LINQ dla klas SQL do swojego projektu.Wyświetli to Object Relational Designer (projektant O/R)O/R Designer umożliwia przeciąganie elementów, do których chcesz uzyskać dostęp w swoim kodzie z Eksploratora serwera/Eksploratora bazy danych na powierzchnię projektowania.Plik LINQ to SQL dodaje obiekt DataContext do projektuTen obiekt zawiera właściwości i kolekcje dla tabel i widoków, do których chcesz uzyskać dostęp oraz metody dla przechowywanych procedur, które chcesz wywołać.Po zapisaniu zmian do programu LINQ to SQL (.dbml) plik, można uzyskać dostęp tych obiektów w kodzie przez odwoływanie się do DataContext obiektu, który jest zdefiniowany przez projektanta O/R.Obiekt DataContext dla Twojego projektu jest nazwany na podstawie nazwy pliku LINQ to SQL.Na przykład plik LINQ to SQL o nazwie Northwind.dbml utworzy obiekt DataContext o nazwie NorthwindDataContext.

Przykłady z instrukcjami krok po kroku – zobacz: Porady: zapytanie dotyczące bazy danych za pomocą LINQ (Visual Basic) i Porady: wywoływanie procedury przechowywanej za pomocą LINQ (Visual Basic).

Funkcje Visual Basic obsługujące LINQ

Visual Basic obejmuje inne zauważalne cechy, które sprawiają, że korzystanie z LINQ jest proste i zmniejszają ilość kodu, który należy napisać, aby wykonać zapytania LINQ.Obbejmują następujące:

• Typy anonimowe, umożliwiają tworzenie nowego typu opartego na wynikach zapytania.

• Pośrednio wpisane zmienne, które umożliwiają odroczenie określania typu i umożliwiają wywnioskowanie typu przez kompilator w oparciu o wyniki kwerendy.

• Metody rozszerzające pozwalają rozszerzyć istniejący typ własnymi metodami bez konieczności jego modyfikowania.

Szczegółowe informacje – zobacz: Funkcje Visual Basic obsługujące LINQ.

Wykonanie odroczonych i natychmiastowych zapytań

Wykonywanie kwerendy różni się od tworzenia kwerendy.Po utworzeniu zapytania, jego wykonanie zostanie wywołane przez oddzielny mechanizm.Zapytanie może być wykonywane tak szybko, jak to zdefiniowano (natychmiastowe wykonanie), lub definicja może być przechowywana a zapytanie może być wykonane później (wykonanie odroczone).

Domyślnie podczas tworzenia zapytania, samo zapytanie nie jest wykonywane natychmiast.Zamiast tego, definicja kwerendy jest przechowywana w zmiennej, która jest używana do odwołania się do wyniku kwerendy.Kiedy wchodzisz do wyniku zapytania później w kodzie, takim jak w pętli For…Next, zapytanie jest wykonywane.proces jest nazywany odroczonym wykonaniem.

Kwerendy mogą być również wykonywane, gdy są zdefiniowane, co jest określane jako natychmiastowe wykonanie.Możesz wyzwolić natychmiastowe wykonanie, stosując metodę która wymaga dostępu do indywidualnych elementów wyniku zapytania.Może to być wynikiem dodania funkcji agregującej, takiej jak Count, Sum, Average, Min lub Max.Aby uzyskać więcej informacji na temat funkcji agregujących, zobacz Aggregate — Klauzula (Visual Basic).

Korzystanie z metod ToList lub ToArray również wymusi natychmiastowe wykonanie.Może być to użyteczne kiedy chcemy przeprowadzić zapytanie natychmiastowo i zapisać wyniki w pamięci podręcznej.Aby uzyskać informacje o tych metodach, zobacz Konwertowanie typów danych.

Aby uzyskać więcej informacji o wykonaniu zapytania — zobacz Pisanie pierwszej kwerendy LINQ (Visual Basic).

XML w języku Visual Basic

Funkcje XML Visual Basic obejmują literały XML i właściwości osi XML, które umożliwiają łatwe tworzenie, dostęp, zapytanie i modyfikację XML w kodzie.Literały XML umożliwiają pisanie XML bezpośrednio w Twoim kodzie.Kompilator Visual Basic traktuje XML jako obiekt pierwszej klasy.

Poniższy przykład kodu pokazuje, jak utworzyć XML element, uzyskać dostęp do jego elementów podrzędnych i atrybutów i zbadać zawartość elementu za pomocą LINQ.

' Place Imports statements at the top of your program.   
Imports <xmlns:ns="http://SomeNamespace">

Module Sample1

    Sub SampleTransform()

        ' Create test by using a global XML namespace prefix.  

        Dim contact = 
            <ns:contact>
                <ns:name>Patrick Hines</ns:name>
                <ns:phone ns:type="home">206-555-0144</ns:phone>
                <ns:phone ns:type="work">425-555-0145</ns:phone>
            </ns:contact>

        Dim phoneTypes = 
          <phoneTypes>
              <%= From phone In contact.<ns:phone> 
                  Select <type><%= phone.@ns:type %></type> 
              %>
          </phoneTypes>

        Console.WriteLine(phoneTypes)
    End Sub 

End Module

Aby uzyskać więcej informacji, zobacz XML w Visual Basic.

Zasoby pokrewne

Tematy Jak to zrobić oraz instruktaże

Porady: zapytanie dotyczące bazy danych za pomocą LINQ (Visual Basic)

Porady: wywoływanie procedury przechowywanej za pomocą LINQ (Visual Basic)

Porady: modyfikowanie danych w bazie danych za pomocą LINQ (Visual Basic)

Porady: łączenie danych w LINQ za pomocą sprzężeń (Visual Basic)

Porady: sortowanie wyników zapytania za pomocą LINQ (Visual Basic)

Porady: filtrowanie wyników zapytania za pomocą LINQ (Visual Basic)

Porady: zliczanie, sumowanie, lub uśrednianie danych za pomocą LINQ (Visual Basic)

Porady: znajdowanie wartości minimalnej lub maksymalnej w wyniku zapytania za pomocą LINQ (Visual Basic)

Walkthrough: Creating LINQ to SQL Classes (O/R Designer)

How to: Assign Stored Procedures to Perform Updates, Inserts, and Deletes (O/R Designer)

Polecane rozdziały książki

Chapter 17: LINQ w Programming Visual Basic 2008

Zobacz też

Zadania

Przykłady interfejsów LINQ

Koncepcje

Przegląd LINQ to XML w Visual Basic

LINQ to DataSet Overview

DataContext Methods (O/R Designer)

Inne zasoby

LINQ (zapytania o języku zintegrowanym)

LINQ to SQL [LINQ to SQL]

Object Relational Designer (O/R Designer)