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á Equals operátor .
Syntax
Join element In collection _
[ joinClause _ ]
[ groupJoinClause ... _ ]
On key1 Equals key2 [ And key3 Equals key4 [... ]
Součásti
element Požadované. Řídicí proměnná pro kolekci, která je připojena.
collection
Povinná hodnota. Kolekce, která se má kombinovat s kolekcí identifikované na levé straně Join operátoru. Klauzule Join může být vnořená v jiné Join klauzuli nebo v Group Join klauzuli .
joinClause
Nepovinný parametr. Jedna nebo více Join dalších klauzulí pro další upřesnění dotazu.
groupJoinClause
Nepovinný parametr. Jedna nebo více Group Join dalších klauzulí pro další upřesnění dotazu.
key1 Equals key2
Povinná hodnota. Identifikuje klíče pro kolekce, které jsou připojeny. K porovnání klíčů z připojených kolekcí je nutné použít Equals operátor . Podmínky spojení můžete kombinovat pomocí And operátoru k identifikaci více klíčů. key1 musí být z kolekce na levé straně Join operátoru. key2 musí být z kolekce na pravé straně Join operátoru.
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ý klíčový výraz 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íčů z připojených kolekcí. Výsledná kolekce může obsahovat libovolnou kombinaci hodnot z kolekce identifikované na levé straně operátoru a kolekce Join identifikované v Join klauzuli . Dotaz vrátí pouze výsledky, pro které je splněna podmínka Equals zadaná operátorem. To je ekvivalentem v INNER JOIN SQL.
V dotazu můžete použít více klauzulí a spojit dvě nebo více Join kolekcí do jedné kolekce.
Pokud chcete kombinovat kolekce bez klauzule , můžete provést implicitní Join spojení. Chcete-li to provést, zahrjte do klauzule více klauzulí a zadejte klauzuli, která identifikuje klíče, které chcete použít In From pro Where spojení.
Pomocí klauzule Group Join můžete kombinovat kolekce do jedné hierarchické kolekce. Je to jako v LEFT OUTER JOIN SQL.
Příklad 1
Následující příklad kódu provede implicitní spojení a zkombinuje seznam zákazníků s jejich 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
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
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
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
V příkladu bude 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