Clausola Join (Visual Basic)
Combina due raccolte in un'unica raccolta. L'operazione di join si basa sulle chiavi corrispondenti e usa l'operatore Equals.
Sintassi
Join element In collection _
[ joinClause _ ]
[ groupJoinClause ... _ ]
On key1 Equals key2 [ And key3 Equals key4 [... ]
Parti
element Obbligatorio. Variabile di controllo per la raccolta in fase di aggiunta.
collection
Obbligatorio. Raccolta da combinare con quella che si trova sul lato sinistro dell'operatore Join. Una clausola Join può essere annidata in un'altra clausola Join o in una clausola Group Join.
joinClause
Facoltativo. Una o più clausole Join aggiuntive per perfezionare ulteriormente la query.
groupJoinClause
Facoltativo. Una o più clausole Group Join aggiuntive per perfezionare ulteriormente la query.
key1 Equals key2
Obbligatorio. Identifica le chiavi per le raccolte in fase di aggiunta. È necessario usare l'operatore Equals per confrontare le chiavi delle raccolte in fase di aggiunta. È possibile combinare le condizioni di join usando l'operatore And per identificare più chiavi. key1 deve provenire dalla raccolta a sinistra dell'operatore Join. key2 deve provenire dalla raccolta a destra dell'operatore Join.
Le chiavi usate nella condizione di join possono essere espressioni che includono più elementi della raccolta. Tuttavia, ogni espressione chiave può contenere solo elementi della rispettiva raccolta.
Osservazioni:
La clausola Join combina due raccolte in base ai valori di chiave corrispondenti delle raccolte unite in join. La raccolta risultante può contenere qualsiasi combinazione di valori della raccolta identificata sul lato sinistro dell'operatore Join e della raccolta identificata nella clausola Join. La query restituirà solo i risultati per i quali viene soddisfatta la condizione specificata dall'operatore Equals. È l'equivalente di un INNER JOIN in SQL.
È possibile usare più clausole Join in una query per unire due o più raccolte in una singola raccolta.
È possibile eseguire un join implicito per combinare raccolte senza la clausola Join. A tale scopo, includere più clausole In nella clausola From e specificare una clausola Where che identifica le chiavi da usare per il join.
È possibile usare la clausola Group Join per combinare le raccolte in una singola raccolta gerarchica. È come un LEFT OUTER JOIN in SQL.
Esempio 1
Nell'esempio di codice seguente viene eseguito un join implicito per combinare un elenco di clienti con gli ordini.
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
Esempio 2
Nell'esempio di codice seguente vengono unite due raccolte usando la clausola Join.
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
In questo esempio viene prodotto un output simile al seguente:
winlogon (968), Windows Logon
explorer (2424), File Explorer
cmd (5136), Command Window
Esempio 3
Nell'esempio di codice seguente vengono unite due raccolte usando la clausola Join con due colonne chiave.
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
In questo esempio viene prodotto un output simile al seguente:
winlogon (968), Windows Logon, Priority = 13
cmd (700), Command Window, Priority = 8
explorer (2424), File Explorer, Priority = 8
