この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Enumerable.Distinct<TSource> メソッド (IEnumerable<TSource>)

 

公開日: 2016年10月

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

名前空間:   System.Linq
アセンブリ:  System.Core (System.Core.dll 内)

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

パラメーター

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

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

戻り値

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

IEnumerable<T> ソース シーケンスから一意の要素を格納しています。

型パラメーター

TSource

要素の型 sourceします。

Exception Condition
ArgumentNullException

sourcenull です。

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

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

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

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

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

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

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> クラスのジェネリック インターフェイスです。 カスタム データ型にこのインターフェイスを実装でき、次のコード例に示します GetHashCodeEquals メソッドです。

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

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

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

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
3.5 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: