Visual Basic'de LINQ'e Giriş

Dil ile Tümleşik Sorgu (LINQ), Visual Basic öğesine sorgu özellikleri ekler ve her türden veriyle çalışırken size basit ve güçlü özellikler sağlar.Bir sorguyu işlenmek üzere bir veritabanına göndermek yerine veya arama yaptığınız her veri türü için farklı sorgu sözdizimiyle çalışmak yerine LINQ, sorguları Visual Basic dilinin bir parçası olarak sağlar.Veri türünden bağımsız olarak birleştirilmiş sözdizimi kullanır.

LINQ, bir SQL Server veritabanından, XML, bellek içi dizi ve koleksiyonlardan, ADO.NET veri kümelerinden veya LINQ destekleyen herhangi bir diğer uzak ya da yerel veri kaynağından veri sorgulamanıza olanak tanır.Tüm bunları Visual Basic dil öğelerini kullanarak yapabilirsiniz.Sorgularınız Visual Basic dilinde yazıldığından, sorgu sonuçlarınız türü kesin olarak belirtilmiş nesneler olarak döner.Bu nesneler, daha hızlı kod yazmanızı ve sorgularınızdaki hataları çalışma zamanında değil derleme zamanında yakalamanızı sağlayan IntelliSense desteği sunar.LINQ sorguları sonuçları iyileştirmek için ek sorgu kaynakları olarak kullanılabilir.Bunlar, kullanıcıların sorgu sonuçlarını daha kolay görüntülemesi ve değiştirmesi için denetimlere bağlı da olabilir.

Örneğin, aşağıdaki kod örneği bir koleksiyon dahilindeki müşteri listesini döndüren ve bulundukları konuma göre gruplandıran LINQ sorgusunu gösterir.

' 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

Bu konuda, aşağıdaki alanlarla ilgili bilgileri bulabilirsiniz:

• Örnekleri Çalıştırma

• LINQ Sağlayıcıları

• Bir LINQ Sorgusunun yapısı

• Visual Basic LINQ Sorgu İşleçleri

• LINQ to SQL Kullanarak bir Veritabanına Bağlanma

• LINQ Destekleyen Visual Basic Özellikleri

• Ertelenmiş ve Anlık Sorgu Yürütme

• Visual Basic içindeki XML

• İlgili Kaynaklar

• Nasıl Yapılır ve İzlenecek Yol Konuları

Örnekleri Çalıştırma

Giriş ve "Bir LINQ Sorgusunun Yapısı" bölümlerindeki örnekleri çalıştırmak için müşteri ve sipariş listesi döndüren aşağıdaki kodu ekleyin.

' 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

LINQ Sağlayıcıları

LINQ sağlayıcı, Visual Basic LINQ sorgularınızı sorgulanan veri kaynağıyla eşler.LINQ sorgusu yazdığınızda, sağlayıcı sorguyu alır ve veri kaynağının yürütebileceği komutlara çevirir.Sağlayıcı kaynaktan alınan verileri sorgu sonucunuzu oluşturan nesnelere dönüştürür.Son olarak, güncelleştirmeleri veri kaynağına gönderdiğinizde nesneleri verilere dönüştürür.

Visual Basic aşağıdaki LINQ sağlayıcıları içerir.

Bir LINQ Sorgusunun yapısı

Genellikle sorgu ifadesi olarak anılan LINQ sorgusu, sorgu için veri kaynaklarını ve yineleme değişkenlerini tanımlayan sorgu yan tümcelerinin bileşiminden oluşur.Sorgu ifadesi; sıralama, filtreleme, gruplama ve katılma için yönergeleri veya kaynak verilere uygulanacak hesaplamaları da içerebilir.Sorgu ifadesi sözdizimi SQL sözdizimine benzer ancak sözdiziminin daha fazla bir kısmı size tanıdık gelebilir.

Sorgu ifadesi From yan tümcesiyle başlar.Bu yan tümce sorgu ve kaynak verilerin her bir öğesine başvurmak için kullanılan değişkenleri ayrıca tanımlar.Bu değişkenlere aralık değişkenleri veya yineleme değişkenleri denir.From yan tümcesi, From yan tümcesinin isteğe bağlı olduğu Aggregate sorguları dışında bir sorgu için gereklidir.Sorgunun kapsamı ve kaynağı, From veya Aggregate yan tümcelerinde tanımlandıktan sonra sorguyu daha iyi hale getirmek için sorgu yan tümcelerinin birleşimini dahil edebilirsiniz.Sorgu yan tümceleri hakkında ayrıntılar için bu konunun ilerleyen bölümlerindeki Visual Basic LINQ Sorgu İşleçleri kısmına bakın.Örneğin, aşağıdaki sorgu müşteri verilerinin kaynak koleksiyonunu customers değişkeni ve cust adında bir yineleme değişkeni olarak tanımlar.

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

Bu örnek tek başına geçerli bir sorgudur ancak sonucu iyileştirmek için daha fazla sorgu yan tümcesi eklediğinizde sorgu daha güçlü hale gelir.Örneğin, sonucu bir veya daha fazla değere göre filtrelemek için Where tümcesini ekleyebilirsiniz.Sorgu ifadeleri tek satırlık kodlardır, ek sorgu yan tümcelerini sorgunun sonuna ekleyebilirsiniz.Alt çizgi (_) satır devam karakterini kullanarak bir sorguyu birden fazla satıra bölebilir ve daha kolay okunmasını sağlayabilirsiniz.Aşağıdaki kod örneği, bir Where yan tümcesi içeren sorgu örneğini gösterir.

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

Başka bir güçlü sorgu yan tümcesi ise, veri kaynağından yalnızca seçili alanları döndürmenizi sağlayan Select yan tümcesidir.LINQ sorguları, numaralandırılabilir, türü kesin belirlenmiş nesne koleksiyonları döndürür.Sorgu, anonim türlerin veya adlandırılmış türlerin koleksiyonunu döndürebilir.Select yan tümcesini kullanarak veri kaynağından tek bir alan döndürebilirsiniz.Bunu yaptığınızda, döndürülen koleksiyon türü o tek alanın türüdür.Veri kaynağından birden fazla alan döndürmek için Select yan tümcesini de kullanabilirsiniz.Bunu yaptığınızda, döndürülen koleksiyon türü yeni bir anonim türdür.Belirtilen adlandırılmış tür alanlarını sorgu tarafından döndürülen alanlarla da eşleştirebilirsiniz.Aşağıdaki kod örneği, veri kaynağının seçilen alanlarından alınan verilerle doldurulmuş üyeleri olan anonim türler koleksiyonunu döndüren bir sorgu ifadesi gösterir.

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

LINQ sorguları ayrıca birden fazla veri kaynağını birleştirmek ve tek bir sonuç döndürmek için kullanılabilir.Bu bir veya daha fazla From yan tümcesi ya da Join veya Group Join sorgu yan tümceleri kullanılarak yapılabilir.Aşağıdaki kod örneği, müşteri ile sipariş verilerini birleştiren ve müşteri ile sipariş verilerini içeren anonim türlerin koleksiyonunu döndüren bir sorgu ifadesini gösterir.

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.

Group Join yan tümcesini kullanarak müşteri nesnesi koleksiyonu içeren hiyerarşik bir sonuç oluşturabilirsiniz.Her müşteri nesnesi, o müşteriye ait tüm siparişleri içeren koleksiyonu içeren bir özelliğe sahiptir.Aşağıdaki kod örneği, müşteri ile sipariş verilerini bir hiyerarşi sonucu olarak birleştiren ve anonim türlerin koleksiyonunu döndüren bir sorgu ifadesini gösterir.Sorgu, müşterinin sipariş verilerinin bir koleksiyonunu içeren CustomerOrders özelliğine sahip bir tür döndürür.Ayrıca söz konusu müşterinin tüm siparişlerine ilişkin toplamı içeren OrderTotal özelliğini de içerir. (Bu sorgu, LEFT OUTER JOIN ile eşdeğerdir.)

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

Güçlü sorgu ifadeleri oluşturmak için kullanabileceğiniz birçok ek LINQ sorgu işleci vardır.Bu konunun sonraki bölümünde, bir sorgu ifadesine dahil edebileceğiniz çeşitli sorgu yan tümceleri açıklanır.Visual Basic sorgu yan tümceleri hakkındaki ayrıntılar için bkz. Sorgular (Visual Basic).

Visual Basic LINQ Sorgu İşleçleri

System.Linq ad alanındaki ve diğer ad alanlarındaki LINQ sorgularını destekleyen sınıflar, uygulamanızın ihtiyaçlarına bağlı olarak sorgular oluşturmak ve daraltmak için çağırabileceğiniz yöntemler içerir.Visual Basic aşağıdaki tabloda açıklandığı üzere sık kullanılan çoğu sorgu yan tümcesi için anahtar sözcükler içerir.

' 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)

Visual Basic sorgu yan tümceleri hakkındaki ayrıntılar için bkz. Sorgular (Visual Basic).

LINQ tarafından sağlanan numaralandırılabilir ve sorgulanabilir türleri üyelerini çağırarak ek LINQ sorgu özelliklerini kullanabilirsiniz.Bir sorgu ifadesinin sonucunda belirli bir sorgu işlecini çağırarak bu ek özellikleri kullanabilirsiniz.Örneğin, aşağıdaki kod örnekleri iki sorgunun sonuçlarını tek bir sorgu sonucunda birleştirmek için Union``1 yöntemini kullanır.Sorgu sonucunu genel listeye eklemek için ToList``1 yöntemini kullanır.

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

Ek LINQ özellikleri için bkz. Standart Sorgu İşleçlerine Genel Bakış.

LINQ to SQL Kullanarak bir Veritabanına Bağlanma

Tablolar, görünümler ve saklı yordamlar gibi LINQ to SQL dosyasını kullanarak erişmek istediğiniz SQL Server veritabanı nesnelerini Visual Basiciçinde tanımlarsınız.LINQ to SQL dosyası, .dbml uzantısına sahiptir.

Geçerli bir SQL Server veritabanı bağlantınız olduğunda projenize LINQ to SQL Classes öğesi ekleyebilirsiniz.Bu, Object Relational Designer (O/R tasarımcısı) gösterecek.O/R Tasarımcısı kodunuzda erişmek istediğiniz öğeleri Sunucu Gezgini/Veritabanı Gezgini'nden tasarımcı yüzeyine sürükleme olanağı sağlar.SQL dosyası için LINQ projenize bir DataContext nesnesi ekler.Bu nesne, erişmek istediğiniz tablolar ve görünümler için özellikler ve koleksiyonlar, çağırmak istediğiniz saklı yordamlar için yöntemler içerir.Değişiklikleri LINQ to SQL (.dbml) dosyasına kaydettikten sonra O/R Tasarımcısı tarafından tanımlanan DataContext nesnesine başvurarak kodunuzdaki bu nesnelere erişebilirsiniz.Projenizin DataContext nesnesi LINQ to SQL dosyanızın adı temel alınarak adlandırılır.Örneğin, Northwind.dbml olarak adlandırılan bir LINQ to SQL dosyası NorthwindDataContext adında bir DataContext nesnesi oluşturur.

Adım adım yönergeleri içeren örnekler için bkz. Nasıl yapılır: LINQ Kullanarak Veritabanını Sorgulama (Visual Basic) ve Nasıl yapılır: Bir Saklı Yordamı LINQ Kullanarak Çağırma (Visual Basic).

LINQ Destekleyen Visual Basic Özellikleri

Visual Basic, LINQ kullanımını basitleştiren ve LINQ sorguları gerçekleştirmek için yazmanız gereken kod miktarını azaltan başka önemli özellikler de içerir.Bunlar aşağıdakileri içerir:

• Bir sorgu sonucuna bağlı olarak yeni bir tür oluşturmanızı sağlayan Anonim türler.

• Örtülü türdeki değişkenler, bir tür belirterek ertelemenize ve derleyicinin sorgu sonucuna göre türü çıkarabilmesine olanak sağlar.

• Genişletme yöntemleri, türün kendisini değiştirmeden, kendi yöntemlerinizle mevcut türü genişletmenize olanak tanır.

Ayrıntılar için bkz. LINQ'i Destekleyen Visual Basic Özellikleri.

Ertelenmiş ve Anlık Sorgu Yürütme

Sorgu yürütme, sorgu oluşturmadan farklıdır.Sorgu oluşturulduktan sonra yürütmesi ayrı bir mekanizma tarafından tetiklenir.Sorgu tanımlandığı anda (hemen yürütme) yürütülebilir veya tanım saklanır ve sorgu daha sonra yürütülebilir (ertelenmiş yürütme).

Varsayılan olarak, bir sorgu oluşturduğunuzda, sorgunun kendisi anında yürütmeye başlamaz.Bunun yerine, sorgu tanımı sorgu sonucuna başvuru olarak kullanılan değişkenin içinde saklanır.Sorgu sonucu değişkenine kodun daha sonraki kısımlarında For…Next döngüsü bir bölümde erişildiğinde sorgu yürütülür.Bu işlem ertelenmiş yürütme olarak adlandırılır.

Sorgular tanımlandıklarında yürütülebilir bu işleme anında yürütme denir.Sorgu sonucundaki öğelere erişim gerektiren bir yöntem uygulayarak anında tetikleme yapılmasını sağlayabilirsiniz.Bu, Count, Sum, Average, Min veya Max gibi bir toplama işlevinin dahil edilmesinin sonucu olabilir.Toplama işlevleri hakkında daha fazla bilgi için bkz. Aggregate Tümcesi (Visual Basic).

ToList veya ToArray yöntemleri de anında yürütmeyi zorunlu kılacaktır.Bu, hemen bir sorgu yürütmek ve sonuçları önbelleğe almak istediğiniz durumlarda yararlı olabilir.Bu yöntemler hakkında daha fazla bilgi için bkz. Veri Türlerini Dönüştürme.

Sorgu yürütme hakkında daha fazla bilgi için bkz. İlk LINQ Sorgunuzu Yazma (Visual Basic).

Visual Basic içindeki XML

Visual Basic içindeki XML öğeleri, XML değişmez değerlerini ve XML eksen özelliklerini içerir ve bunlar kodunuzdaki XML öğelerini kolayca oluşturmanızı, erişmenizi, sorgulamanızı ve değiştirmenizi sağlar.XML harfleri, kodunuzda doğrudan XML yazmanıza olanak sağlar.Visual Basic derleyicisi, XML'e birinci sınıf veri nesnesi gibi davranır.

Aşağıdaki kod örneği bir XML öğesinin nasıl oluşturulduğunu, alt öğelerine ve özniteliklerine nasıl erişileceğini ve öğe içeriklerinin LINQ kullanılarak nasıl sorgulanacağını gösterir.

' 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

Daha fazla bilgi için bkz. Visual Basic'de XML.

İlgili Kaynaklar

Nasıl Yapılır ve İzlenecek Yol Konuları

Nasıl yapılır: LINQ Kullanarak Veritabanını Sorgulama (Visual Basic)

Nasıl yapılır: Bir Saklı Yordamı LINQ Kullanarak Çağırma (Visual Basic)

Nasıl yapılır: LINQ Kullanarak Veritabanındaki Verileri Değiştirme (Visual Basic)

Nasıl yapılır: Birleştirmeleri Kullanarak Verileri LINQ İle Birleştirme (Visual Basic)

Nasıl yapılır: Sorgu Sonuçlarını LINQ Kullanarak Sıralama (Visual Basic)

Nasıl yapılır: Sorgu Sonuçlarını LINQ Kullanarak Filtreleme (Visual Basic)

Nasıl yapılır: LINQ Kullanarak Count, Sum veya Average Verisi (Visual Basic)

Nasıl yapılır: LINQ Kullanarak Bir Sorgu Sonucunda En Düşük ve En Fazla Değeri Bulma (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)

Özel Kitap Başlıkları

Programming Visual Basic 2008 içindeki Chapter 17: LINQ

Ayrıca bkz.

Görevler

LINQ Örnekleri

Kavramlar

Visual Basic'de LINQ - XML Dönüşümüne Genel Bakış

LINQ to DataSet Overview

DataContext Methods (O/R Designer)

Diğer Kaynaklar

LINQ (Dil ile Tümleşik Sorgu)

LINQ to SQL [LINQ to SQL]

Object Relational Designer (O/R Designer)