Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

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 di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Sequenza da cui rimuovere elementi duplicati.

Valore restituito

Tipo: System.Collections.Generic.IEnumerable<TSource>
Oggetto IEnumerable<T> che contiene elementi distinti dalla sequenza di origine.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IEnumerable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

source è null.

Questo metodo viene implementato tramite esecuzione posticipata. Il valore restituito immediato è un oggetto che contiene tutte le informazioni necessarie all'esecuzione dell'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato tramite chiamata diretta al relativo metodo GetEnumerator o utilizzando l'oggetto foreach in Visual C# oppure For Each in Visual Basic.

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

Nella sintassi di una espressione di query in Visual Basic, una clausola Distinct viene convertita in una chiamata di Distinct.

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

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

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare Distinct<TSource>(IEnumerable<TSource>) per restituire 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
            */



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


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 avere implementato questa interfaccia, è possibile utilizzare una sequenza di oggetti Product nel metodo Distinct<TSource>(IEnumerable<TSource>), 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
*/


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: 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 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft