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.Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)

 

Publicado: noviembre de 2016

Proporciona la diferencia de conjuntos de dos secuencias mediante especificado IEqualityComparer<T> para comparar valores.

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

public static IEnumerable<TSource> Except<TSource>(
	this IEnumerable<TSource> first,
	IEnumerable<TSource> second,
	IEqualityComparer<TSource> comparer
)

Parámetros

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

Una IEnumerable<T> cuyos elementos que no estén además en second se devolverá.

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

Una IEnumerable<T> cuyos elementos que también aparezcan en la primera secuencia harán esos elementos que se va a quitar de la secuencia devuelta.

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

IEqualityComparer<T> para comparar valores.

Valor devuelto

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

Una secuencia que contiene la diferencia de conjuntos de los elementos de dos secuencias.

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.

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

En el ejemplo siguiente se muestra cómo implementar un comparador de igualdad que se puede usar en la Except<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 Except<TSource> método, tal como se muestra en el ejemplo siguiente.

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

Product[] fruits2 = { new Product { Name = "apple", Code = 9 } };

//Get all the elements from the first array
//except for the elements from the second array.

IEnumerable<Product> except =
    fruits1.Except(fruits2, new ProductComparer());

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

/*
  This code produces the following output:

  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: