Join – klauzule (Visual Basic)

Kombinuje dvě kolekce do jedné kolekce. Operace spojení je založená na odpovídajících klíčích a používá operátor Equals .

Syntaxe

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

Součástky

element Požadovaný. Řídicí proměnná pro kolekci, která je připojena.

collection
Povinný: Kolekce, která se má kombinovat s kolekcí identifikovanou na levé straně operátoru Join . Join Klauzuli lze vnořit do jiné Join klauzule nebo v klauzuliGroup Join.

joinClause
Nepovinné. Jedna nebo více dalších Join klauzulí pro další upřesnění dotazu.

groupJoinClause
Nepovinné. Jedna nebo více dalších Group Join klauzulí pro další upřesnění dotazu.

key1 Equals key2
Povinný: Identifikuje klíče pro spojené kolekce. Operátor musíte použít Equals k porovnání klíčů z připojených kolekcí. Podmínky spojení můžete kombinovat pomocí operátoru And k identifikaci více klíčů. key1 musí být z kolekce na levé straně operátoru Join . key2 musí být z kolekce na pravé straně operátoru Join .

Klíče použité v podmínce spojení mohou být výrazy, které obsahují více než jednu položku z kolekce. Každý výraz klíče však může obsahovat pouze položky z příslušné kolekce.

Poznámky

Klauzule Join kombinuje dvě kolekce na základě odpovídajících hodnot klíče z připojených kolekcí. Výsledná kolekce může obsahovat libovolnou kombinaci hodnot z kolekce identifikované na levé straně operátoru Join a kolekce identifikované v Join klauzuli. Dotaz vrátí pouze výsledky, pro které je splněna podmínka zadaná operátorem Equals . To je ekvivalentem v INNER JOIN SQL.

V dotazu můžete použít více Join klauzulí pro spojení dvou nebo více kolekcí do jedné kolekce.

Implicitní spojení můžete provést pro kombinování kolekcí bez Join klauzule. Pokud to chcete udělat, zahrňte do klauzule From více In klauzulí a zadejte Where klauzuli, která identifikuje klíče, které chcete použít pro spojení.

Klauzuli Group Join můžete použít ke kombinování kolekcí do jedné hierarchické kolekce. To je jako LEFT OUTER JOIN v SQL.

Příklad 1

Následující příklad kódu provede implicitní spojení a zkombinuje seznam zákazníků se svými objednávkami.

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

Příklad 2

Následující příklad kódu spojí dvě kolekce pomocí Join klauzule.

Imports System.Diagnostics

Public Class JoinSample

    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

Tento příklad vytvoří výstup podobný následujícímu:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

Příklad 3

Následující příklad kódu spojí dvě kolekce pomocí Join klauzule se dvěma klíčovými sloupci.

Imports System.Diagnostics

Public Class JoinSample2

    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

Příklad vytvoří výstup podobný následujícímu:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8

Viz také