Compartir a través de


Join (Cláusula, Visual Basic)

Combina dos colecciones en una sola. La operación de combinación se basa en claves coincidentes y usa el operador Equals.

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

Elementos

  • element
    Requerido. Variable de control de la colección que se va a combinar.

  • collection
    Requerido. Colección que se va a combinar con la colección identificada a la izquierda del operador Join. Una cláusula Join puede estar anidada en otra cláusula Join o en una cláusula Group Join.

  • joinClause
    Opcional. Una o varias cláusulas Join adicionales para delimitar más la consulta.

  • groupJoinClause
    Opcional. Una o varias cláusulas Group Join adicionales para delimitar más la consulta.

  • key1 Equals key2
    Requerido. Identifica las claves de las colecciones que se van a combinar. Debe usar el operador Equals para comparar las claves de las colecciones que se van a combinar. Puede combinar las condiciones de combinación mediante el operador And para identificar varias claves. El parámetro key1 debe proceder de la colección de la izquierda del operador Join. key2 debe proceder de la colección de la derecha del operador Join.

    Las claves que se usan 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 solamente puede contener elementos de su colección respectiva.

Comentarios

La cláusula Join combina dos colecciones basándose en los valores de clave coincidentes de las colecciones que se van a combinar. La colección resultante puede contener cualquier combinación de valores de la colección identificada a la izquierda del operador Join y de la colección identificada en la cláusula Join. La consulta solamente devolverá los resultados para los que se cumpla la condición especificada en el operador Equals. Esto es equivalente a INNER JOIN en SQL.

Puede usar varias cláusulas Join en una consulta para combinar dos o más colecciones en una sola colección.

Puede realizar una combinación implícita para combinar las colecciones sin la cláusula Join. Para ello, incluya varias cláusulas In en la cláusula From y especifique una cláusula Where que identifique las claves que desee usar para la combinación.

Puede usar la cláusula Group Join para combinar colecciones en una sola colección jerárquica. Esto equivale a LEFT OUTER JOIN en SQL.

Ejemplo

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

En el ejemplo de código siguiente se combinan dos colecciones mediante la cláusula Join.

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 generará un resultado similar al siguiente:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

En el ejemplo de código siguiente se combinan dos colecciones mediante la cláusula Join 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 generará un resultado similar al siguiente:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8

Vea también

Referencia

Select (Cláusula, Visual Basic)

From (Cláusula, Visual Basic)

Group Join (Cláusula, Visual Basic)

Where (Cláusula, Visual Basic)

Conceptos

Introducción a LINQ en Visual Basic

Otros recursos

Consultas de Visual Basic