Join Tümcesi (Visual Basic)

İki koleksiyonu tek bir koleksiyonda birleştirir. Birleştirme işlemi eşleşen anahtarları temel alarak işleci Equals kullanır.

Syntax

Join element In collection _
  [ joinClause _ ]
  [ groupJoinClause ... _ ]
On key1 Equals key2 [ And key3 Equals key4 [... ]

Bölümler

element Gerekli. Bir araya olan koleksiyon için denetim değişkeni.

collection
Gereklidir. işlecinin sol tarafında tanımlanan koleksiyonla birleştirecek Join koleksiyon. Bir Join yan tümcesi başka bir yan Join tümcede veya yan tümcesinde iç içe Group Join geçmiş olabilir.

joinClause
İsteğe bağlı. Sorguyu daha da Join geliştirmek için bir veya daha fazla ek yan tümce.

groupJoinClause
İsteğe bağlı. Sorguyu daha da Group Join geliştirmek için bir veya daha fazla ek yan tümce.

key1 Equals key2
Gereklidir. Bir araya olan koleksiyonların anahtarlarını tanımlar. Birleştirilen Equals koleksiyonlardan anahtarları karşılaştırmak için işleci kullan gerekir. Birden çok anahtarı tanımlamak için işleci kullanarak And birleştirme koşullarını birleştirin. key1 işlecinin sol tarafındaki koleksiyondan Join olması gerekir. key2 işlecinin sağ tarafındaki koleksiyondan Join olması gerekir.

Birleştirme koşulunda kullanılan anahtarlar, koleksiyondan birden fazla öğe içeren ifadeler olabilir. Ancak, her anahtar ifadesi yalnızca ilgili koleksiyonundan öğeleri içerebilir.

Açıklamalar

yan Join tümcesi, birleştirilmiş koleksiyonlardan eşleşen anahtar değerlerine göre iki koleksiyonu birleştirir. Sonuçta elde edilen koleksiyon, işlecinin sol tarafında tanımlanan koleksiyondan ve yan tümcesinde tanımlanan Join koleksiyondan herhangi bir değer Join birleşimini içerebilir. Sorgu yalnızca işleç tarafından belirtilen koşulun karşılandı olduğu Equals sonuçları verir. Bu, bir in INNER JOIN SQL.

İki veya daha fazla Join koleksiyonu tek bir koleksiyonda birleştirmek için bir sorguda birden çok yan tümce kullanabilirsiniz.

Koleksiyonları yan tümcesi olmadan birleştirmek için örtülü birleştirme Join gerçekleştirin. Bunu yapmak için yan tümcenize birden çok yan tümcesi dahil edildi ve birleşim için kullanmak istediğiniz anahtarları tanımlayan In From bir yan Where tümce belirtin.

Koleksiyonları tek Group Join bir hiyerarşik koleksiyonda birleştirmek için yan tümcesini kullanabilirsiniz. Bu, bir in LEFT OUTER JOIN SQL.

Örnek 1

Aşağıdaki kod örneği, bir müşteri listesini siparişleriyle birleştirmek için örtülü bir birleşim gerçekleştirir.

Dim customerIDs() = {"ALFKI", "VICTE", "BLAUS", "TRAIH"}

Dim customerList = From cust In customers, custID In customerIDs
                   Where cust.CustomerID = custID
                   Select cust.CompanyName

For Each companyName In customerList
    Console.WriteLine(companyName)
Next

Örnek 2

Aşağıdaki kod örneği yan tümcesini kullanarak iki koleksiyonu Join bir arada sunar.

Imports System.Diagnostics
Imports System.Security.Permissions

Public Class JoinSample

    <SecurityPermission(SecurityAction.Demand)>
    Public Sub ListProcesses()
        Dim processDescriptions As New List(Of ProcessDescription)
        processDescriptions.Add(New ProcessDescription With {
                                    .ProcessName = "explorer",
                                    .Description = "Windows Explorer"})
        processDescriptions.Add(New ProcessDescription With {
                                    .ProcessName = "winlogon",
                                    .Description = "Windows Logon"})
        processDescriptions.Add(New ProcessDescription With {
                                    .ProcessName = "cmd",
                                    .Description = "Command Window"})
        processDescriptions.Add(New ProcessDescription With {
                                    .ProcessName = "iexplore",
                                    .Description = "Internet Explorer"})

        Dim processes = From proc In Process.GetProcesses
                        Join desc In processDescriptions
                          On proc.ProcessName Equals desc.ProcessName
                        Select proc.ProcessName, proc.Id, desc.Description

        For Each proc In processes
            Console.WriteLine("{0} ({1}), {2}",
                              proc.ProcessName, proc.Id, proc.Description)
        Next
    End Sub

End Class

Public Class ProcessDescription
    Public ProcessName As String
    Public Description As String
End Class

Bu örnek aşağıdakine benzer bir çıkış oluşturur:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

Örnek 3

Aşağıdaki kod örneği, iki anahtar sütunuyla yan Join tümcesini kullanarak iki koleksiyonu bir arada sunar.

Imports System.Diagnostics
Imports System.Security.Permissions

Public Class JoinSample2

    <SecurityPermission(SecurityAction.Demand)>
    Public Sub ListProcesses()
        Dim processDescriptions As New List(Of ProcessDescription2)

        ' 8 = Normal priority, 13 = High priority
        processDescriptions.Add(New ProcessDescription2 With {
                                    .ProcessName = "explorer",
                                    .Description = "Windows Explorer",
                                    .Priority = 8})
        processDescriptions.Add(New ProcessDescription2 With {
                                    .ProcessName = "winlogon",
                                    .Description = "Windows Logon",
                                    .Priority = 13})
        processDescriptions.Add(New ProcessDescription2 With {
                                    .ProcessName = "cmd",
                                    .Description = "Command Window",
                                    .Priority = 8})
        processDescriptions.Add(New ProcessDescription2 With {
                                    .ProcessName = "iexplore",
                                    .Description = "Internet Explorer",
                                    .Priority = 8})

        Dim processes = From proc In Process.GetProcesses
                        Join desc In processDescriptions
                          On proc.ProcessName Equals desc.ProcessName And
                             proc.BasePriority Equals desc.Priority
                        Select proc.ProcessName, proc.Id, desc.Description,
                               desc.Priority

        For Each proc In processes
            Console.WriteLine("{0} ({1}), {2}, Priority = {3}",
                              proc.ProcessName,
                              proc.Id,
                              proc.Description,
                              proc.Priority)
        Next
    End Sub

End Class

Public Class ProcessDescription2
    Public ProcessName As String
    Public Description As String
    Public Priority As Integer
End Class

Örnek, aşağıdakine benzer bir çıkış oluşturur:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8

Ayrıca bkz.