Enumerable.Distinct Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Gibt unterschiedliche Elemente aus einer Sequenz zurück

Überlädt

Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Gibt mithilfe eines angegebenen IEqualityComparer<T> zum Vergleichen von Werten unterschiedliche Elemente aus einer Sequenz zurück
Distinct<TSource>(IEnumerable<TSource>)	Gibt mithilfe des Standardgleichheitsvergleichs zum Vergleichen von Werten unterschiedliche Elemente aus einer Sequenz zurück

Hinweise

Die Ergebnissequenz ist ungeordnet.

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

Quelle:

Distinct.cs

Gibt mithilfe eines angegebenen IEqualityComparer<T> zum Vergleichen von Werten unterschiedliche Elemente aus einer Sequenz zurück

C#

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Die Sequenz, aus der doppelte Elemente entfernt werden sollen.

comparer

IEqualityComparer<TSource>

Ein IEqualityComparer<T> zum Vergleichen von Werten.

Gibt zurück

IEnumerable<TSource>

Ein IEnumerable<T>, das unterschiedliche Elemente aus der Quellsequenz enthält

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Das folgende Beispiel zeigt, wie ein Gleichheitsvergleich implementiert wird, der in der Distinct -Methode verwendet werden kann.

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

Nachdem Sie diesen Vergleich implementiert haben, können Sie eine Sequenz von Product -Objekten in der Distinct -Methode verwenden, wie im folgenden Beispiel gezeigt:

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

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

Die Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) -Methode gibt eine ungeordnete Sequenz zurück, die keine doppelten Werte enthält. Wenn comparer ist null, wird der Standardgleichheitsvergleich , verwendet, Defaultum Werte zu vergleichen.

Distinct<TSource>(IEnumerable<TSource>)

Quelle:

Distinct.cs

Gibt mithilfe des Standardgleichheitsvergleichs zum Vergleichen von Werten unterschiedliche Elemente aus einer Sequenz zurück

C#

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IEnumerable<TSource>

Die Sequenz, aus der doppelte Elemente entfernt werden sollen.

Gibt zurück

IEnumerable<TSource>

Ein IEnumerable<T>, das unterschiedliche Elemente aus der Quellsequenz enthält

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Distinct<TSource>(IEnumerable<TSource>) , um unterschiedliche Elemente aus einer Sequenz von ganzen Zahlen zurückzugeben.

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

Wenn Sie unterschiedliche Elemente aus Sequenzen von Objekten eines benutzerdefinierten Datentyps zurückgeben möchten, müssen Sie die IEquatable<T> generische Schnittstelle in der -Klasse implementieren. Das folgende Codebeispiel zeigt, wie Sie diese Schnittstelle in einem benutzerdefinierten Datentyp implementieren und Methoden und Equals bereitstellenGetHashCode.

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

Nachdem Sie diese Schnittstelle implementiert haben, können Sie eine Sequenz von Product -Objekten in der Distinct<TSource>(IEnumerable<TSource>) -Methode verwenden, wie im folgenden Beispiel gezeigt:

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

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

Die Distinct<TSource>(IEnumerable<TSource>) -Methode gibt eine ungeordnete Sequenz zurück, die keine doppelten Werte enthält. Zum Vergleichen von Werten wird der Standardgleichheitsvergleich Defaultverwendet.

In der Visual Basic-Abfrageausdruckssyntax wird eine Distinct -Klausel in einen Aufruf von Distinctübersetzt.

Der Standardgleichheitsvergleich wird verwendet, Defaultum Werte der Typen zu vergleichen, die die IEquatable<T> generische Schnittstelle implementieren. Um einen benutzerdefinierten Datentyp zu vergleichen, müssen Sie diese Schnittstelle implementieren und eigene GetHashCode Methoden und Equals für den Typ bereitstellen.

Ein Beispiel, das verwendet IEqualityComparer<T> , um einen benutzerdefinierten Vergleich zu definieren, finden Sie unter Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>).

Weitere Informationen

• Distinct-Klausel (Visual Basic)