Group Join (Cláusula, Visual Basic)

  • Artículo

Combina dos colecciones en una sola colección jerárquica. La operación de combinación se basa en claves coincidentes.

Sintaxis

Group Join element [As type] In collection _  
  On key1 Equals key2 [ And key3 Equals key4 [... ] ] _  
  Into expressionList

Partes

Término Definición
element Obligatorio. Variable de control para la colección que se va a combinar.
type Opcional. Tipo de element. Si no se especifica type, el tipo de element se deduce de collection.
collection Necesario. Colección que se va a combinar con la colección que se encuentra en el lado izquierdo del operador Group Join. Una cláusula Group Join se puede anidar en una cláusula Join o en otra cláusula Group Join.
key1 Equals key2 Necesario. 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 condiciones de combinación mediante el operador And para identificar varias claves. El parámetro key1 debe ser de la colección del lado izquierdo del operador Join. El parámetro key2 debe ser de la colección del lado derecho del operador Join.

Las claves usadas en la condición de combinación pueden ser expresiones que incluyan más de un elemento de la colección. Sin embargo, cada expresión de clave solo puede contener elementos de su colección respectiva.
expressionList Necesario. Una o más expresiones que identifican cómo se agregan los grupos de elementos de la colección. Si desea identificar el nombre de un miembro para los resultados agrupados, use la palabra clave Group (<alias> = Group). También puede incluir funciones de agregado para aplicar al grupo.

Comentarios

La cláusula Group Join combina dos colecciones basadas en los valores clave coincidentes de las colecciones que se van a combinar. La colección resultante puede contener un miembro que haga referencia a una colección de elementos de la segunda colección que coincidan con el valor de clave de la primera colección. También puede especificar funciones de agregado que se aplicarán a los elementos agrupados de la segunda colección. Para información sobre las funciones agregadas, consulte Cláusula Aggregate.

Considere, por ejemplo, una colección de administradores y una colección de empleados. Los elementos de ambas colecciones tienen una propiedad ManagerID que identifica a los empleados que rinden cuentas a un administrador determinado. Los resultados de una operación de combinación contendrán un resultado para cada administrador y empleado con un valor ManagerID coincidente. Los resultados de una operación Group Join contendrán la lista completa de administradores. Cada resultado de administrador tendrá un miembro que hace referencia a la lista de empleados que es coincidencia para el administrador específico.

La colección que resulta a partir de una operación Group Join puede contener cualquier combinación de valores de la colección que se identifica en la cláusula From y las expresiones identificadas en la cláusula Into de la cláusula Group Join. Para más información sobre las expresiones válidas para la cláusula Into, consulte Cláusula Aggregate.

Una operación Group Join devolverá todos los resultados de la colección identificada en el lado izquierdo del operador Group Join. Esto se cumple incluso si no hay coincidencias en la colección que se combina. Es similar a LEFT OUTER JOIN en SQL.

Puede usar la cláusula Join para combinar colecciones en una colección única. Esto equivale a INNER JOIN en SQL.

Ejemplo

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

Dim customerList = From cust In customers
                   Group Join ord In orders On
                   cust.CustomerID Equals ord.CustomerID
                   Into CustomerOrders = Group,
                        OrderTotal = Sum(ord.Total)
                   Select cust.CompanyName, cust.CustomerID,
                          CustomerOrders, OrderTotal

For Each customer In customerList
    Console.WriteLine(customer.CompanyName &
                      " (" & customer.OrderTotal & ")")

    For Each order In customer.CustomerOrders
        Console.WriteLine(vbTab & order.OrderID & ": " & order.Total)
    Next
Next

Consulte también