Join (Cláusula, Visual Basic)
Combina dos colecciones en una sola colección. La operación de combinación se basa en claves que coinciden y usa el Equals operador .
Sintaxis
Join element In collection _
[ joinClause _ ]
[ groupJoinClause ... _ ]
On key1 Equals key2 [ And key3 Equals key4 [... ]
Partes
element Obligatorio. Variable de control para la colección que se va a unir.
collection
Necesario. Colección que se combinará con la colección identificada en el lado izquierdo del Join operador . Una Join cláusula se puede anidar en otra cláusula o en una cláusula Join Group Join .
joinClause
Opcional. Una o varias Join cláusulas adicionales para refinar aún más la consulta.
groupJoinClause
Opcional. Una o varias Group Join cláusulas adicionales para refinar aún más la consulta.
key1 Equals key2
Necesario. Identifica las claves de las colecciones que se unen. Debe usar el operador Equals para comparar las claves de las colecciones que se están unyéndo. Puede combinar condiciones de combinación mediante el operador And para identificar varias claves. key1 debe ser de la colección en el lado izquierdo del Join operador . key2 debe ser de la colección en el lado derecho del Join operador .
Las claves usadas en la condición de combinación pueden ser expresiones que incluyen más de un elemento de la colección. Sin embargo, cada expresión de clave solo puede contener elementos de su colección correspondiente.
Comentarios
La Join cláusula combina dos colecciones basadas en los valores de clave correspondientes de las colecciones que se están combinando. La colección resultante puede contener cualquier combinación de valores de la colección identificada en el lado izquierdo del operador y la Join colección identificada en la cláusula Join . La consulta devolverá solo los resultados para los que se cumple la condición especificada por Equals el operador . Esto equivale a un INNER JOIN en SQL.
Puede usar varias Join cláusulas en una consulta para unir dos o más colecciones en una sola colección.
Puede realizar una combinación implícita para combinar colecciones sin la Join cláusula . Para ello, incluya varias cláusulas en la cláusula y especifique una cláusula que identifique las claves que desea usar In From para la Where combinación.
Puede usar la cláusula Group Join para combinar colecciones en una única colección jerárquica. Esto es como un LEFT OUTER JOIN en SQL.
Ejemplo 1
En el ejemplo de código siguiente se realiza una combinación implícita para combinar una lista de clientes con sus pedidos.
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
Ejemplo 2
En el ejemplo de código siguiente se unen dos colecciones mediante la Join cláusula .
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
Este ejemplo producirá una salida similar a la siguiente:
winlogon (968), Windows Logon
explorer (2424), File Explorer
cmd (5136), Command Window
Ejemplo 3
En el ejemplo de código siguiente se unen dos colecciones mediante Join la cláusula con dos columnas de clave.
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
El ejemplo producirá una salida similar a la siguiente:
winlogon (968), Windows Logon, Priority = 13
cmd (700), Command Window, Priority = 8
explorer (2424), File Explorer, Priority = 8