Enumerable.UnionBy メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

オーバーロード

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)	指定したキー セレクター関数に従って、2 つのシーケンスの集合和集合を生成します。
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	指定したキー セレクター関数に従って、2 つのシーケンスの集合和集合を生成します。

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

ソース:

Union.cs

指定したキー セレクター関数に従って、2 つのシーケンスの集合和集合を生成します。

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ UnionBy(System::Collections::Generic::IEnumerable<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second, Func<TSource, TKey> ^ keySelector);

public static System.Collections.Generic.IEnumerable<TSource> UnionBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, Func<TSource,TKey> keySelector);

static member UnionBy : seq<'Source> * seq<'Source> * Func<'Source, 'Key> -> seq<'Source>

<Extension()>
Public Function UnionBy(Of TSource, TKey) (first As IEnumerable(Of TSource), second As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IEnumerable(Of TSource)

型パラメーター

TSource

入力シーケンスの要素の型。

TKey

要素を識別するキーの種類。

パラメーター

first

IEnumerable<TSource>

和集合の最初のセットを形成する一意の要素を含む IEnumerable<T>。

second

IEnumerable<TSource>

和集合の 2 番目のセットを形成する一意の要素を含む IEnumerable<T>。

keySelector

Func<TSource,TKey>

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

戻り値

IEnumerable<TSource>

2 つの入力シーケンスの要素 (重複する要素は除く) を格納している IEnumerable<T>。

例外

ArgumentNullException

first または second が null です。

注釈

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

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

このメソッドによって返されるオブジェクトが列挙されると、 UnionBy をsecondその順序で列挙firstし、まだ生成されていない各要素を生成します。

こちらもご覧ください

• Union と UnionBy の例

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

ソース:

Union.cs

指定したキー セレクター関数に従って、2 つのシーケンスの集合和集合を生成します。

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ UnionBy(System::Collections::Generic::IEnumerable<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

public static System.Collections.Generic.IEnumerable<TSource> UnionBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

static member UnionBy : seq<'Source> * seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IEqualityComparer<'Key> -> seq<'Source>

<Extension()>
Public Function UnionBy(Of TSource, TKey) (first As IEnumerable(Of TSource), second As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IEqualityComparer(Of TKey)) As IEnumerable(Of TSource)

型パラメーター

TSource

入力シーケンスの要素の型。

TKey

要素を識別するキーの種類。

パラメーター

first

IEnumerable<TSource>

和集合の最初のセットを形成する一意の要素を含む IEnumerable<T>。

second

IEnumerable<TSource>

和集合の 2 番目のセットを形成する一意の要素を含む IEnumerable<T>。

keySelector

Func<TSource,TKey>

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

comparer

IEqualityComparer<TKey>

値を比較する IEqualityComparer<T>。

戻り値

IEnumerable<TSource>

2 つの入力シーケンスの要素 (重複する要素は除く) を格納している IEnumerable<T>。

例外

ArgumentNullException

first または second が null です。

注釈

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

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

このメソッドによって返されるオブジェクトが列挙されると、 UnionBy をsecondその順序で列挙firstし、まだ生成されていない各要素を生成します。

こちらもご覧ください

• Union と UnionBy の例