Join (Cláusula, Visual Basic)Join Clause (Visual Basic)

Combina dos colecciones en una sola colección.Combines two collections into a single collection. La operación de combinación se basa en las claves coincidentes y utiliza el operador Equals.The join operation is based on matching keys and uses the Equals operator.

SintaxisSyntax

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

ElementosParts

element Obligatorio.element Required. Variable de control de la colección que se va a combinar.The control variable for the collection being joined.

collection
Requerido.Required. Colección que se va a combinar con la colección identificada en el lado izquierdo del operador Join.The collection to combine with the collection identified on the left side of the Join operator. Una cláusula Join se puede anidar en otra cláusula Join o en una cláusula Group Join.A Join clause can be nested in another Join clause, or in a Group Join clause.

joinClause
Opcional.Optional. Una o varias cláusulas de Join adicionales para restringir aún más la consulta.One or more additional Join clauses to further refine the query.

groupJoinClause
Opcional.Optional. Una o varias cláusulas de Group Join adicionales para restringir aún más la consulta.One or more additional Group Join clauses to further refine the query.

key1 Equals key2key1 Equals key2
Requerido.Required. Identifica las claves para las colecciones que se están combinando.Identifies keys for the collections being joined. Debe utilizar el operador Equals para comparar las claves de las colecciones que se están combinando.You must use the Equals operator to compare keys from the collections being joined. Puede combinar condiciones de combinación mediante el operador And para identificar varias claves.You can combine join conditions by using the And operator to identify multiple keys. key1 debe ser de la colección en el lado izquierdo del operador de Join.key1 must be from the collection on the left side of the Join operator. key2 debe ser de la colección del lado derecho del operador de Join.key2 must be from the collection on the right side of the Join operator.

Las claves utilizadas en la condición de combinación pueden ser expresiones que incluyen más de un elemento de la colección.The keys used in the join condition can be expressions that include more than one item from the collection. Sin embargo, cada expresión clave solo puede contener elementos de su colección respectiva.However, each key expression can contain only items from its respective collection.

ComentariosRemarks

La cláusula Join combina dos colecciones basadas en los valores de clave coincidentes de las colecciones que se van a combinar.The Join clause combines two collections based on matching key values from the collections being joined. La colección resultante puede contener cualquier combinación de valores de la colección identificada en el lado izquierdo del operador Join y la colección identificada en la cláusula Join.The resulting collection can contain any combination of values from the collection identified on the left side of the Join operator and the collection identified in the Join clause. La consulta devolverá solo los resultados para los que se cumple la condición especificada por el operador Equals.The query will return only results for which the condition specified by the Equals operator is met. Esto es equivalente a un INNER JOIN en SQL.This is equivalent to an INNER JOIN in SQL.

Puede usar varias cláusulas Join en una consulta para combinar dos o más colecciones en una sola colección.You can use multiple Join clauses in a query to join two or more collections into a single collection.

Puede realizar una combinación implícita para combinar colecciones sin la cláusula Join.You can perform an implicit join to combine collections without the Join clause. Para ello, incluya varias cláusulas In en la cláusula From y especifique una cláusula Where que identifique las claves que desea usar para la combinación.To do this, include multiple In clauses in your From clause and specify a Where clause that identifies the keys that you want to use for the join.

Puede usar la cláusula Group Join para combinar colecciones en una sola colección jerárquica.You can use the Group Join clause to combine collections into a single hierarchical collection. Esto es como un LEFT OUTER JOIN en SQL.This is like a LEFT OUTER JOIN in SQL.

EjemploExample

En el ejemplo de código siguiente se realiza una combinación implícita para combinar una lista de clientes con sus pedidos.The following code example performs an implicit join to combine a list of customers with their orders.

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

EjemploExample

En el ejemplo de código siguiente se combinan dos colecciones mediante la cláusula Join.The following code example joins two collections by using the Join clause.

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á una salida similar a la siguiente:This example will produce output similar to the following:

winlogon (968), Windows Logon

explorer (2424), File Explorer

cmd (5136), Command Window

EjemploExample

En el ejemplo de código siguiente se combinan dos colecciones mediante la cláusula Join con dos columnas de clave.The following code example joins two collections by using the Join clause with two key columns.

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

En el ejemplo se producirá una salida similar a la siguiente:The example will produce output similar to the following:

winlogon (968), Windows Logon, Priority = 13

cmd (700), Command Window, Priority = 8

explorer (2424), File Explorer, Priority = 8

Vea tambiénSee also