Distinct(TSource) Metodo (IEnumerable(TSource))
Comprimi il sommario
Espandi il sommario
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Enumerable.Distinct<TSource>(IEnumerable<TSource>)

 

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

Spazio dei nomi:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IEnumerable<TSource> Distinct<TSource>(
	this IEnumerable<TSource> source
)

Parametri

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

Sequenza da cui rimuovere elementi duplicati.

Valore restituito

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

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

Parametri di tipo

TSource

Tipo degli elementi di source.

Exception Condition
ArgumentNullException

source è null.

Questo metodo viene implementato tramite 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 finché l'oggetto viene enumerata chiamando il relativo GetEnumerator metodo direttamente o tramite foreach in Visual C# o For Each in Visual Basic.

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

In Visual Basic sintassi dell'espressione di query un Distinct clausola viene convertita in una chiamata di Distinct<TSource>.

Operatore di uguaglianza predefinito Default, viene utilizzato per confrontare i valori dei tipi che implementano il IEquatable<T> interfaccia generica. Per confrontare un tipo di dati personalizzato, è necessario implementare questa interfaccia e fornire il proprio GetHashCode e Equals metodi per il tipo.

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

Esempio di codice seguente viene illustrato come utilizzare Distinct<TSource>(IEnumerable<TSource>) per restituire gli elementi distinti da una sequenza di numeri interi.

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 il IEquatable<T> interfaccia generica della classe. Esempio di codice seguente viene illustrato come implementare questa interfaccia in un tipo di dati personalizzati e fornire GetHashCode e Equals metodi.

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

    public bool Equals(Product 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 utilizzare una sequenza di Product gli oggetti di Distinct<TSource>(IEnumerable<TSource>) metodo, come illustrato nell'esempio seguente.

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();

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

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

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 3.5
Portable Class Library
Supportato in: portable .NET platforms
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra:
© 2016 Microsoft