Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

Proporciona la diferencia de conjuntos de dos secuencias utilizando el comparador de igualdad predeterminado para comparar los 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
)

Parámetros de tipo

TSource

Tipo de los elementos de las secuencias de entrada.

Parámetros

first
Tipo: System.Collections.Generic.IEnumerable<TSource>
IEnumerable<T> cuyos elementos que no se encuentren en second se van a devolver.
second
Tipo: System.Collections.Generic.IEnumerable<TSource>
IEnumerable<T> cuyos elementos que también aparecen en la primera secuencia harán que se quiten esos elementos de la secuencia devuelta.

Valor devuelto

Tipo: System.Collections.Generic.IEnumerable<TSource>
Una secuencia que contiene la diferencia de conjuntos de los elementos de dos secuencias.

Nota sobre el uso

En Visual Basic y C#, se puede llamar a este método como a un método de instancia en cualquier objeto de tipo IEnumerable<TSource>. Cuando emplee la sintaxis del método de instancia para llamar a este método, omita el primer parámetro. Para obtener más información, vea Métodos de extensión (Visual Basic) o Métodos de extensión (Guía de programación de C#).

ExcepciónCondición
ArgumentNullException

first o second es null.

Este método se implementa usando 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 mediante una llamada directa a su método GetEnumerator o a través de foreach en Visual C# o For Each en Visual Basic.

La diferencia de dos conjuntos se define como los miembros del primer conjunto que no aparecen en el segundo conjunto.

NotaNota

Este método devuelve los elementos de first que no aparecen en second. Sin embargo, no devuelve los elementos de second que no aparecen en first.

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

En el ejemplo de código siguiente se muestra cómo se usa el método Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) para comparar dos secuencias de números y devolver elementos que solo aparecen en la primera secuencia.


            double[] numbers1 = { 2.0, 2.1, 2.2, 2.3, 2.4, 2.5 };
            double[] numbers2 = { 2.2 };

            IEnumerable<double> onlyInFirstSet = numbers1.Except(numbers2);

            foreach (double number in onlyInFirstSet)
                Console.WriteLine(number);

            /*
             This code produces the following output:

             2
             2.1
             2.3
             2.4
             2.5
            */



Si desea comparar secuencias de objetos de un tipo de datos personalizado, tiene que implementar la interfaz genérica de IEqualityComparer<T> en una clase auxiliar. El siguiente ejemplo de código muestra cómo implementar esta interfaz en un tipo de datos personalizado y proporcionar los métodos Equals y GetHashCode.


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 objetos ProductA en el método Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>), como se muestra en el siguiente ejemplo.


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

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

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

        IEnumerable<ProductA> except =
            fruits1.Except(fruits2);

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

        /*
          This code produces the following output:

          orange 4
          lemon 12
        */



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft