Enumerable.Distinct メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

シーケンスから一意の要素を返します。

オーバーロード

Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	指定された IEqualityComparer<T> を使用して値を比較することにより、シーケンスから一意の要素を返します。
Distinct<TSource>(IEnumerable<TSource>)	既定の等値比較子を使用して値を比較することにより、シーケンスから一意の要素を返します。

注釈

結果シーケンスは順序付けされません。

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

ソース:

Distinct.cs

指定された IEqualityComparer<T> を使用して値を比較することにより、シーケンスから一意の要素を返します。

C#

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

型パラメーター

TSource

source の要素の型。

パラメーター

source

IEnumerable<TSource>

重複する要素を削除する対象となるシーケンス。

comparer

IEqualityComparer<TSource>

値を比較する IEqualityComparer<T>。

戻り値

IEnumerable<TSource>

ソース シーケンスの一意の要素を格納する IEnumerable<T>。

例外

ArgumentNullException

source が nullです。

例

次の例は、 メソッドで使用できる等値比較子を実装する方法を Distinct 示しています。

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

この比較子を実装した後、次の例に示すように、 メソッドでDistinctオブジェクトのProductシーケンスを使用できます。

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

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) 、重複する値を含まない順序なしのシーケンスを返します。 が nullの場合comparer、値の比較には既定の等値比較子 Defaultが使用されます。

Distinct<TSource>(IEnumerable<TSource>)

ソース:

Distinct.cs

既定の等値比較子を使用して値を比較することにより、シーケンスから一意の要素を返します。

C#

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

型パラメーター

TSource

source の要素の型。

パラメーター

source

IEnumerable<TSource>

重複する要素を削除する対象となるシーケンス。

戻り値

IEnumerable<TSource>

ソース シーケンスの一意の要素を格納する IEnumerable<T>。

例外

ArgumentNullException

source が nullです。

例

次のコード例では、 を使用 Distinct<TSource>(IEnumerable<TSource>) して、整数のシーケンスから個別の要素を返す方法を示します。

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

カスタム データ型のオブジェクトのシーケンスから個別の要素を返す場合は、 クラスにジェネリック インターフェイスを IEquatable<T> 実装する必要があります。 次のコード例は、このインターフェイスをカスタム データ型に実装し、 メソッドと Equals メソッドを提供GetHashCodeする方法を示しています。

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

このインターフェイスを実装した後、次の例に示すように、 メソッドでDistinct<TSource>(IEnumerable<TSource>)オブジェクトのProductシーケンスを使用できます。

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

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# または For Each Visual Basic で を使用foreachして列挙されるまで実行されません。

メソッドは Distinct<TSource>(IEnumerable<TSource>) 、重複する値を含まない順序なしのシーケンスを返します。 既定の等値比較子 を使用して値 Defaultを比較します。

Visual Basic クエリ式の構文では、 句は Distinct の Distinct呼び出しに変換されます。

既定の等値比較子 は、 Defaultジェネリック インターフェイスを実装する型の値を IEquatable<T> 比較するために使用されます。 カスタム データ型を比較するには、このインターフェイスを実装し、型に独自 GetHashCode の メソッドと Equals メソッドを提供する必要があります。

を使用 IEqualityComparer<T> してカスタム 比較子を定義する例については、「」を参照してください Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)。

こちらもご覧ください

• Distinct 句 (Visual Basic)