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>, IEqualityComparer<TSource>)

 

Publicado: octubre de 2016

Proporciona la unión de conjuntos de dos secuencias mediante un objeto IEqualityComparer<T>.

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,
	IEqualityComparer<TSource> comparer
)

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.

comparer
Type: System.Collections.Generic.IEqualityComparer<TSource>

El IEqualityComparer<T> para comparar valores.

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.

Si comparer es null, el comparador de igualdad predeterminado, Default, se utiliza para comparar valores.

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.

El Concat<TSource> método difiere de la Union<TSource> método porque el Concat<TSource> método devuelve todos los elementos de las secuencias de entrada que incluye duplicados, mientras que Union<TSource> devuelve sólo los valores únicos.

En el ejemplo siguiente se muestra cómo implementar un comparador de igualdad que se puede usar en la Union<TSource> (método).

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

// Custom comparer for the Product class
class ProductComparer : IEqualityComparer<Product>
{
    // Products are equal if their names and product numbers are equal.
    public bool Equals(Product x, Product y)
    {

        //Check whether the compared objects reference the same data.
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether any of the compared objects is null.
        if (Object.ReferenceEquals(x, null) || Object.ReferenceEquals(y, null))
            return false;

        //Check whether the products' properties are equal.
        return x.Code == y.Code && x.Name == y.Name;
    }

    // If Equals() returns true for a pair of objects 
    // then GetHashCode() must return the same value for these objects.

    public int GetHashCode(Product product)
    {
        //Check whether the object is null
        if (Object.ReferenceEquals(product, null)) return 0;

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

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

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

}

Después de implementar este comparador, puede utilizar secuencias de Product los objetos de la Union<TSource> método, tal como se muestra en el ejemplo siguiente.

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

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

IEnumerable<Product> union =
  store1.Union(store2, new ProductComparer());

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: