Enumerable.Distinct Metodo

Definizione

Spazio dei nomi:

System.Linq

Assembly:

System.Linq.dll

Restituisce elementi distinti da una sequenza.

Overload

Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Restituisce elementi distinti da una sequenza utilizzando uno specificato IEqualityComparer<T> per confrontare valori.
Distinct<TSource>(IEnumerable<TSource>)	Restituisce elementi distinti da una sequenza utilizzando l'operatore di confronto uguaglianze predefinito per confrontare i valori.

Commenti

La sequenza di risultati non è ordinata.

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

Origine:

Distinct.cs

Restituisce elementi distinti da una sequenza utilizzando uno specificato IEqualityComparer<T> per confrontare valori.

C#

public static System.Collections.Generic.IEnumerable<TSource> Distinct<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source

IEnumerable<TSource>

Sequenza da cui rimuovere elementi duplicati.

comparer

IEqualityComparer<TSource>

Oggetto IEqualityComparer<T> per confrontare i valori.

Restituisce

IEnumerable<TSource>

Oggetto IEnumerable<T> che contiene elementi distinti dalla sequenza di origine.

Eccezioni

ArgumentNullException

source è null.

Esempio

Nell'esempio seguente viene illustrato come implementare un operatore di confronto di uguaglianza che può essere usato nel Distinct metodo .

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

Dopo aver implementato questo operatore di confronto, è possibile usare una sequenza di Product oggetti nel Distinct metodo , come illustrato nell'esempio seguente:

C#

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

// Exclude duplicates.

IEnumerable<Product> noduplicates =
    products.Distinct(new ProductComparer());

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

/*
    This code produces the following output:
    apple 9
    orange 4
    lemon 12
*/

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita fino a quando l'oggetto non viene enumerato chiamando direttamente il relativo GetEnumerator metodo o usando foreach in C# o For Each in Visual Basic.

Il Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) metodo restituisce una sequenza non ordinata che non contiene valori duplicati. Se comparer è null, l'operatore di confronto di uguaglianza predefinito, Default, viene usato per confrontare i valori.

Distinct<TSource>(IEnumerable<TSource>)

Origine:

Distinct.cs

Restituisce elementi distinti da una sequenza utilizzando l'operatore di confronto uguaglianze predefinito per confrontare i valori.

C#

public static System.Collections.Generic.IEnumerable<TSource> Distinct<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source

IEnumerable<TSource>

Sequenza da cui rimuovere elementi duplicati.

Restituisce

IEnumerable<TSource>

Oggetto IEnumerable<T> che contiene elementi distinti dalla sequenza di origine.

Eccezioni

ArgumentNullException

source è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare Distinct<TSource>(IEnumerable<TSource>) per restituire elementi distinti da una sequenza di numeri interi.

C#

List<int> ages = new List<int> { 21, 46, 46, 55, 17, 21, 55, 55 };

IEnumerable<int> distinctAges = ages.Distinct();

Console.WriteLine("Distinct ages:");

foreach (int age in distinctAges)
{
    Console.WriteLine(age);
}

/*
 This code produces the following output:

 Distinct ages:
 21
 46
 55
 17
*/

Se si desidera restituire elementi distinti da sequenze di oggetti di un tipo di dati personalizzato, è necessario implementare l'interfaccia IEquatable<T> generica nella classe . Nell'esempio di codice seguente viene illustrato come implementare questa interfaccia in un tipo di dati personalizzato e fornire GetHashCode metodi e Equals .

C#

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

    public bool Equals(MyProduct other)
    {
        //Check whether the compared object is null.
        if (Object.ReferenceEquals(other, null)) return false;

        //Check whether the compared object references the same data.
        if (Object.ReferenceEquals(this, other)) return true;

        //Check whether the products' properties are equal.
        return Code.Equals(other.Code) && Name.Equals(other.Name);
    }

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

    public override int GetHashCode()
    {

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

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

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

Dopo aver implementato questa interfaccia, è possibile usare una sequenza di Product oggetti nel Distinct<TSource>(IEnumerable<TSource>) metodo , come illustrato nell'esempio seguente:

C#

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

// Exclude duplicates.

IEnumerable<MyProduct> noduplicates =
    products.Distinct();

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

/*
    This code produces the following output:
    apple 9
    orange 4
    lemon 12
*/

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita fino a quando l'oggetto non viene enumerato chiamando direttamente il relativo GetEnumerator metodo o usando foreach in C# o For Each in Visual Basic.

Il Distinct<TSource>(IEnumerable<TSource>) metodo restituisce una sequenza non ordinata che non contiene valori duplicati. Usa l'operatore di confronto di uguaglianza predefinito, Default, per confrontare i valori.

Nella sintassi delle espressioni di query di Visual Basic una Distinct clausola viene convertita in una chiamata di Distinct.

L'operatore di confronto di uguaglianza predefinito, Default, viene usato per confrontare i valori dei tipi che implementano l'interfaccia IEquatable<T> generica. Per confrontare un tipo di dati personalizzato, è necessario implementare questa interfaccia e fornire GetHashCode metodi personalizzati e Equals per il tipo.

Per un esempio che usa IEqualityComparer<T> per definire un operatore di confronto personalizzato, vedere Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>).

Vedi anche

• Clausola Distinct (Visual Basic)