Enumerable.Except Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Produit la différence entre deux séquences.

Surcharges

Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produit la différence entre deux séquences à l'aide du comparateur d'égalité par défaut pour comparer les valeurs.
Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produit la différence entre deux séquences à l'aide du IEqualityComparer<T> spécifié pour comparer les valeurs.

Remarques

La différence de jeu de deux jeux est définie comme les membres du premier jeu qui n’apparaissent pas dans le deuxième jeu.

Cette méthode retourne les éléments dans first qui n’apparaissent pas dans second. Elle ne retourne pas les éléments dans second qui n’apparaissent pas dans first. Seuls les éléments uniques sont retournés.

Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

Source:

Except.cs

Produit la différence entre deux séquences à l'aide du comparateur d'égalité par défaut pour comparer les valeurs.

C#

public static System.Collections.Generic.IEnumerable<TSource> Except<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

Paramètres de type

TSource

Type des éléments des séquences d'entrée.

Paramètres

first

IEnumerable<TSource>

Un IEnumerable<T> dont les éléments ne se trouvent pas également dans second sera retourné.

second

IEnumerable<TSource>

IEnumerable<T> dont les éléments qui figurent également dans la première séquence seront supprimés de la séquence retournée.

Retours

IEnumerable<TSource>

Séquence qui contient la différence entre les éléments de deux séquences.

Exceptions

ArgumentNullException

first ou second est null.

Exemples

L’exemple de code suivant montre comment utiliser la Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) méthode pour comparer deux séquences de nombres et retourner des éléments qui apparaissent uniquement dans la première séquence.

C#

double[] numbers1 = { 2.0, 2.0, 2.1, 2.2, 2.3, 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 vous souhaitez comparer des séquences d’objets d’un type de données personnalisé, vous devez implémenter l’interface IEquatable<T> générique dans une classe d’assistance. L’exemple de code suivant montre comment implémenter cette interface dans un type de données personnalisé et remplacer les GetHashCode méthodes et Equals .

C#

public class ProductA : IEquatable<ProductA>
{
    public string Name { get; set; }
    public int Code { get; set; }

    public bool Equals(ProductA other)
    {
        if (other is null)
            return false;

        return this.Name == other.Name && this.Code == other.Code;
    }

    public override bool Equals(object obj) => Equals(obj as ProductA);
    public override int GetHashCode() => (Name, Code).GetHashCode();
}

Après avoir implémenté cette interface, vous pouvez utiliser des séquences d’objets ProductA dans la Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) méthode, comme illustré dans l’exemple suivant :

C#

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
*/

Remarques

Cette méthode est implémentée à l’aide de l’exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

Le comparateur d’égalité par défaut, Default, est utilisé pour comparer les valeurs des types. Pour comparer un type de données personnalisé, vous devez remplacer les Equals méthodes et et GetHashCode et implémenter éventuellement l’interface IEquatable<T> générique dans le type personnalisé. Pour plus d'informations, consultez la propriété Default.

Except<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)

Source:

Except.cs

Produit la différence entre deux séquences à l'aide du IEqualityComparer<T> spécifié pour comparer les valeurs.

C#

public static System.Collections.Generic.IEnumerable<TSource> Except<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

Paramètres de type

TSource

Type des éléments des séquences d'entrée.

Paramètres

first

IEnumerable<TSource>

Un IEnumerable<T> dont les éléments ne se trouvent pas également dans second sera retourné.

second

IEnumerable<TSource>

IEnumerable<T> dont les éléments qui figurent également dans la première séquence seront supprimés de la séquence retournée.

comparer

IEqualityComparer<TSource>

IEqualityComparer<T> pour comparer les valeurs.

Retours

IEnumerable<TSource>

Séquence qui contient la différence entre les éléments de deux séquences.

Exceptions

ArgumentNullException

first ou second est null.

Exemples

Si vous souhaitez comparer des séquences d’objets d’un type de données personnalisé, vous devez implémenter l’interface IEqualityComparer<T> générique dans une classe d’assistance. L’exemple de code suivant montre comment implémenter cette interface dans un type de données personnalisé et fournir des GetHashCode méthodes et Equals . L’exemple suivant montre comment implémenter un comparateur d’égalité qui peut être utilisé dans la Except méthode .

C#

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;
    }
}

Après avoir implémenté ce comparateur, vous pouvez utiliser des séquences d’objets Product dans la Except méthode, comme illustré dans l’exemple suivant :

C#

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
*/

Remarques

Si comparer est null, le comparateur d’égalité par défaut, Default, est utilisé pour comparer des valeurs.