Ler em inglês

Compartilhar via


Enumerable.UnionBy Método

Definição

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
Origem:
Union.cs
Origem:
Union.cs

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

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

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

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9

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

Origem:
Union.cs
Origem:
Union.cs
Origem:
Union.cs

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

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

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

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET 6, 7, 8, 9