Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Enumerable.Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

 

Publicado: octubre de 2016

Proporciona la unión de conjunto de dos secuencias utilizando el comparador de igualdad predeterminado.

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static IEnumerable<TSource> Union<TSource>(
	this IEnumerable<TSource> first,
	IEnumerable<TSource> second
)

Parámetros

first
Type: System.Collections.Generic.IEnumerable<TSource>

Una IEnumerable<T> cuyos diversos elementos forman el primer conjunto de la unión.

second
Type: System.Collections.Generic.IEnumerable<TSource>

Una IEnumerable<T> cuyos diversos elementos forman el segundo conjunto de la unión.

Valor devuelto

Type: System.Collections.Generic.IEnumerable<TSource>

Un IEnumerable<T> que contiene los elementos de dos secuencias de entrada, excepto los duplicados.

Parámetros de tipo

TSource

Tipo de los elementos de las secuencias de entrada.

Exception Condition
ArgumentNullException

El valor de first o second es null.

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto llamando a su GetEnumerator método directamente o mediante foreach en Visual C# o For Each en Visual Basic.

Este método excluye los duplicados del conjunto devuelto. Este comportamiento es diferente a la Concat<TSource> método, que devuelve todos los elementos de las secuencias de entrada que incluye duplicados.

El comparador de igualdad predeterminado, Default, se utiliza para comparar los valores de los tipos que implementan la IEqualityComparer<T> interfaz genérica. Para comparar un tipo de datos personalizado, debe implementar esta interfaz y proporcionar sus propios GetHashCode y Equals métodos para el tipo.

Cuando se enumera el objeto devuelto por este método, Union<TSource> enumera first y second en ese orden y genera los elementos que ya no se han generado.

En el ejemplo de código siguiente se muestra cómo utilizar Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) para obtener la unión de dos secuencias de enteros.

int[] ints1 = { 5, 3, 9, 7, 5, 9, 3, 7 };
int[] ints2 = { 8, 3, 6, 4, 4, 9, 1, 0 };

IEnumerable<int> union = ints1.Union(ints2);

foreach (int num in union)
{
    Console.Write("{0} ", num);
}

/*
 This code produces the following output:

 5 3 9 7 8 6 4 1 0
*/

Si desea comparar secuencias de objetos de un tipo de datos personalizado, debe implementar la IEqualityComparer<T> interfaz genérica en una helperclass. En el ejemplo de código siguiente se muestra cómo implementar esta interfaz en un tipo de datos personalizado y proporcionar GetHashCode y Equals métodos.

public class ProductA
{ 
    public string Name { get; set; }
    public int Code { get; set; }
}

public class ProductComparer : IEqualityComparer<ProductA>
{

    public bool Equals(ProductA x, ProductA y)
    {
        //Check whether the objects are the same object. 
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether the products' properties are equal. 
        return x != null && y != null && x.Code.Equals(y.Code) && x.Name.Equals(y.Name);
    }

    public int GetHashCode(ProductA obj)
    {
        //Get hash code for the Name field if it is not null. 
        int hashProductName = obj.Name == null ? 0 : obj.Name.GetHashCode();

        //Get hash code for the Code field. 
        int hashProductCode = obj.Code.GetHashCode();

        //Calculate the hash code for the product. 
        return hashProductName ^ hashProductCode;
    }
}

Después de implementar esta interfaz, puede utilizar secuencias de ProductA los objetos de la Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) método, tal como se muestra en el ejemplo siguiente.

ProductA[] store1 = { new ProductA { Name = "apple", Code = 9 }, 
                       new ProductA { Name = "orange", Code = 4 } };

ProductA[] store2 = { new ProductA { Name = "apple", Code = 9 }, 
                       new ProductA { Name = "lemon", Code = 12 } };
//Get the products from the both arrays
//excluding duplicates.

IEnumerable<ProductA> union =
  store1.Union(store2);

foreach (var product in union)
    Console.WriteLine(product.Name + " " + product.Code);

/*
    This code produces the following output:

    apple 9
    orange 4
    lemon 12
*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: