Enumerable.UnionBy Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)	Produz a união definida de duas sequências de acordo com uma função de seletor de chave especificada.
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Produz a união definida de duas sequências de acordo com uma função de seletor de chave especificada.

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

Origem:

Union.cs

Produz a união definida de duas sequências de acordo com uma função de seletor de chave especificada.

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)

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

TKey

O tipo de chave pelo qual identificar elementos.

Parâmetros

first

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos formam o primeiro conjunto da união.

second

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos formam o segundo conjunto da união.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

Retornos

IEnumerable<TSource>

Um IEnumerable<T> que contém os elementos de ambas as sequências de entrada, excluindo as duplicatas.

Exceções

ArgumentNullException

first ou second é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O comparador de igualdade padrão, Default, é usado para comparar valores.

Quando o objeto retornado por esse método é enumerado, UnionBy enumera first e second nessa ordem e produz cada elemento que ainda não foi produzido.

Confira também

• Exemplos de Union e UnionBy

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

Origem:

Union.cs

Produz a união definida de duas sequências de acordo com uma função de seletor de chave especificada.

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)

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

TKey

O tipo de chave pelo qual identificar elementos.

Parâmetros

first

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos formam o primeiro conjunto da união.

second

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos formam o segundo conjunto da união.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

comparer

IEqualityComparer<TKey>

O IEqualityComparer<T> para comparar valores.

Retornos

IEnumerable<TSource>

Um IEnumerable<T> que contém os elementos de ambas as sequências de entrada, excluindo as duplicatas.

Exceções

ArgumentNullException

first ou second é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

Se comparer for null, o comparador de igualdade padrão, Default, será usado para comparar valores.

Quando o objeto retornado por esse método é enumerado, UnionBy enumera first e second nessa ordem e produz cada elemento que ainda não foi produzido.

Confira também

• Exemplos de Union e UnionBy