英語で読む

次の方法で共有


Enumerable.ToLookup メソッド

定義

Lookup<TKey,TElement> からジェネリックの IEnumerable<T> を作成します。

オーバーロード

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

指定されたキー セレクター関数および要素セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

指定されたキー セレクター関数、比較子、および要素セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

指定されたキー セレクター関数およびキーの比較子に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

指定されたキー セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

ソース:
Lookup.cs
ソース:
Lookup.cs
ソース:
Lookup.cs

指定されたキー セレクター関数および要素セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

public static System.Linq.ILookup<TKey,TElement> ToLookup<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector);

型パラメーター

TSource

source の要素の型。

TKey

keySelector によって返されるキーの型。

TElement

elementSelector によって返される値の型。

パラメーター

source
IEnumerable<TSource>

IEnumerable<T> の作成元の Lookup<TKey,TElement>

keySelector
Func<TSource,TKey>

各要素からキーを抽出する関数。

elementSelector
Func<TSource,TElement>

各要素から結果の要素値を生成する変換関数。

戻り値

入力シーケンスから選択された TElement 型の値を格納する Lookup<TKey,TElement>

例外

sourcekeySelector、または elementSelector は、null です。

次のコード例では、 を使用 ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) してキー セレクター関数と要素セレクター関数を使用して を作成 Lookup<TKey,TElement> する方法を示します。

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
    public long TrackingNumber { get; set; }
}

public static void ToLookupEx1()
{
    // Create a list of Packages.
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard",
                  Weight = 25.2, TrackingNumber = 89453312L },
              new Package { Company = "Lucerne Publishing",
                  Weight = 18.7, TrackingNumber = 89112755L },
              new Package { Company = "Wingtip Toys",
                  Weight = 6.0, TrackingNumber = 299456122L },
              new Package { Company = "Contoso Pharmaceuticals",
                  Weight = 9.3, TrackingNumber = 670053128L },
              new Package { Company = "Wide World Importers",
                  Weight = 33.8, TrackingNumber = 4665518773L } };

    // Create a Lookup to organize the packages.
    // Use the first character of Company as the key value.
    // Select Company appended to TrackingNumber
    // as the element values of the Lookup.
    ILookup<char, string> lookup =
        packages
        .ToLookup(p => p.Company[0],
                  p => p.Company + " " + p.TrackingNumber);

    // Iterate through each IGrouping in the Lookup.
    foreach (IGrouping<char, string> packageGroup in lookup)
    {
        // Print the key value of the IGrouping.
        Console.WriteLine(packageGroup.Key);
        // Iterate through each value in the
        // IGrouping and print its value.
        foreach (string str in packageGroup)
            Console.WriteLine("    {0}", str);
    }
}

/*
 This code produces the following output:

 C
     Coho Vineyard 89453312
     Contoso Pharmaceuticals 670053128
 L
     Lucerne Publishing 89112755
 W
     Wingtip Toys 299456122
     Wide World Importers 4665518773
*/

注釈

メソッドは ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) 、キーを Lookup<TKey,TElement>値のコレクションにマップする 1 対多のディクショナリ である を返します。 は Lookup<TKey,TElement> 、キーと Dictionary<TKey,TValue>単一の値の 1 対 1 のマッピングを実行する とは異なります。

キーの比較には、既定の等値比較子 Default が使用されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

ソース:
Lookup.cs
ソース:
Lookup.cs
ソース:
Lookup.cs

指定されたキー セレクター関数、比較子、および要素セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

public static System.Linq.ILookup<TKey,TElement> ToLookup<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.ILookup<TKey,TElement> ToLookup<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

型パラメーター

TSource

source の要素の型。

TKey

keySelector によって返されるキーの型。

TElement

elementSelector によって返される値の型。

パラメーター

source
IEnumerable<TSource>

IEnumerable<T> の作成元の Lookup<TKey,TElement>

keySelector
Func<TSource,TKey>

各要素からキーを抽出する関数。

elementSelector
Func<TSource,TElement>

各要素から結果の要素値を生成する変換関数。

comparer
IEqualityComparer<TKey>

キーを比較する IEqualityComparer<T>

戻り値

入力シーケンスから選択された TElement 型の値を格納する Lookup<TKey,TElement>

例外

sourcekeySelector、または elementSelector は、null です。

注釈

メソッドは ToLookup<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>) 、キーを Lookup<TKey,TElement>値のコレクションにマップする 1 対多のディクショナリ である を返します。 は Lookup<TKey,TElement> 、キーと Dictionary<TKey,TValue>単一の値の 1 対 1 のマッピングを実行する とは異なります。

nullの場合comparer、キーの比較に既定の等値比較子Defaultが使用されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

ソース:
Lookup.cs
ソース:
Lookup.cs
ソース:
Lookup.cs

指定されたキー セレクター関数およびキーの比較子に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

public static System.Linq.ILookup<TKey,TSource> ToLookup<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
public static System.Linq.ILookup<TKey,TSource> ToLookup<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

型パラメーター

TSource

source の要素の型。

TKey

keySelector によって返されるキーの型。

パラメーター

source
IEnumerable<TSource>

IEnumerable<T> の作成元の Lookup<TKey,TElement>

keySelector
Func<TSource,TKey>

各要素からキーを抽出する関数。

comparer
IEqualityComparer<TKey>

キーを比較する IEqualityComparer<T>

戻り値

ILookup<TKey,TSource>

キーと値を格納している Lookup<TKey,TElement>。 各グループ内の値は source と同じ順序になります。

例外

source または keySelectornull です。

注釈

メソッドは ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) 、キーを Lookup<TKey,TElement>値のコレクションにマップする 1 対多のディクショナリ である を返します。 Lookup<TKey,TElement>は、 とは異なりDictionary<TKey,TValue>、キーと単一の値の 1 対 1 のマッピングを実行します。

nullの場合comparer、キーの比較に既定の等値比較子Defaultが使用されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

ソース:
Lookup.cs
ソース:
Lookup.cs
ソース:
Lookup.cs

指定されたキー セレクター関数に従って、Lookup<TKey,TElement> から IEnumerable<T> を作成します。

public static System.Linq.ILookup<TKey,TSource> ToLookup<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

型パラメーター

TSource

source の要素の型。

TKey

keySelector によって返されるキーの型。

パラメーター

source
IEnumerable<TSource>

IEnumerable<T> の作成元の Lookup<TKey,TElement>

keySelector
Func<TSource,TKey>

各要素からキーを抽出する関数。

戻り値

ILookup<TKey,TSource>

キーと値を格納している Lookup<TKey,TElement>。 各グループ内の値は source と同じ順序になります。

例外

source または keySelectornull です。

注釈

メソッドは ToLookup<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) 、キーを Lookup<TKey,TElement>値のコレクションにマップする 1 対多のディクショナリ である を返します。 は Lookup<TKey,TElement> 、キーと Dictionary<TKey,TValue>単一の値の 1 対 1 のマッピングを実行する とは異なります。

キーの比較には、既定の等値比較子 Default が使用されます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0