Enumerable.UnionBy 方法

定義

命名空間:

System.Linq

組件:

System.Linq.dll

多載

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。

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

來源:

Union.cs

根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。

C#

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

類型參數

TSource

輸入序列之項目的類型。

TKey

要識別專案的索引鍵類型。

參數

first

IEnumerable<TSource>

IEnumerable<T>，其獨特項目構成第一個等位集合。

second

IEnumerable<TSource>

IEnumerable<T>，其獨特項目構成第二個等位集合。

keySelector

Func<TSource,TKey>

用來擷取各項目之索引鍵的函式。

傳回

IEnumerable<TSource>

IEnumerable<T>，其中包含來自兩個輸入序列的項目，但不包括重複的項目。

例外狀況

ArgumentNullException

first 或 second 為 null。

備註

這個方法是使用延後執行來實作。 立即傳回值是一個物件，會儲存執行動作所需的所有資訊。 除非直接呼叫其 GetEnumerator 方法或在 C# 或 foreachFor Each Visual Basic 中使用 來列舉對象，否則不會執行這個方法所代表的查詢。

默認相等比較子 Default是用來比較值。

列舉這個方法所傳回的物件時， UnionBy 會 first 依該順序列舉 和 second ，併產生尚未產生的每個專案。

另請參閱

• Union 和 UnionBy 範例

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

來源:

Union.cs

根據指定的索引鍵選取器函式，產生兩個序列的集合聯集。

C#

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

類型參數

TSource

輸入序列之項目的類型。

TKey

要識別專案的索引鍵類型。

參數

first

IEnumerable<TSource>

IEnumerable<T>，其獨特項目構成第一個等位集合。

second

IEnumerable<TSource>

IEnumerable<T>，其獨特項目構成第二個等位集合。

keySelector

Func<TSource,TKey>

用來擷取各項目之索引鍵的函式。

comparer

IEqualityComparer<TKey>

用來比較值的 IEqualityComparer<T>。

傳回

IEnumerable<TSource>

IEnumerable<T>，其中包含來自兩個輸入序列的項目，但不包括重複的項目。

例外狀況

ArgumentNullException

first 或 second 為 null。

備註

這個方法是使用延後執行來實作。 立即傳回值是一個物件，會儲存執行動作所需的所有資訊。 除非直接呼叫其 GetEnumerator 方法或在 C# 或 foreachFor Each Visual Basic 中使用 來列舉對象，否則不會執行這個方法所代表的查詢。

如果 為 comparernull，則會使用預設相等比較子 Default來比較值。

列舉這個方法所傳回的物件時， UnionBy 會 first 依該順序列舉 和 second ，併產生尚未產生的每個專案。

另請參閱

• Union 和 UnionBy 範例