Enumerable.UnionBy Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| 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
- 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.
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 para a união.
- second
- IEnumerable<TSource>
Um IEnumerable<T> cujos elementos distintos formam o segundo conjunto para a união.
- keySelector
- Func<TSource,TKey>
Uma função para extrair a chave para cada elemento.
Retornos
Um IEnumerable<T> que contém os elementos de ambas as sequências de entrada, excluindo duplicatas.
Exceções
first ou second é null.
Exemplos
O exemplo a seguir demonstra como usar UnionBy para mesclar duas coleções de objetos, excluindo duplicatas com base em uma propriedade específica.
public static void UnionByKeySelectorExample()
{
(int ProductId, string Name , decimal Price)[] localProducts =
{
(101, "Laptop", 1000m),
(102, "Mouse", 100m),
(103, "Keyboard", 120m)
};
(int ProductId, string Name, decimal Price)[] warehouseProducts =
{
(102, "Mouse", 100m), // Duplicate ProductId (already in local)
(104, "Monitor", 800m),
(101, "Laptop", 1000m) // Duplicate ProductId (already in local)
};
var combinedProducts =
localProducts.UnionBy(
warehouseProducts,
product => product.ProductId
);
foreach (var product in combinedProducts)
{
Console.WriteLine($"{product.ProductId}: {product.Name} - ${product.Price}");
}
/*
This code produces the following output:
101: Laptop - $1000
102: Mouse - $100
103: Keyboard - $120
104: Monitor - $800
*/
}
Comentários
Esse método é implementado usando a execução adiada. O valor de retorno 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 método GetEnumerator diretamente ou usando foreach em C# ou For Each em Visual Basic.
O comparador Defaultde igualdade padrão é 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
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)
- Origem:
- Union.cs
- Origem:
- Union.cs
- 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.
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 para a união.
- second
- IEnumerable<TSource>
Um IEnumerable<T> cujos elementos distintos formam o segundo conjunto para a união.
- keySelector
- Func<TSource,TKey>
Uma função para extrair a chave para cada elemento.
- comparer
- IEqualityComparer<TKey>
Os IEqualityComparer<T> valores a serem comparados.
Retornos
Um IEnumerable<T> que contém os elementos de ambas as sequências de entrada, excluindo duplicatas.
Exceções
first ou second é null.
Exemplos
O exemplo a seguir demonstra como usar UnionBy para mesclar duas coleções ao usar um comparador personalizado para ignorar a confidencialidade de maiúsculas e minúsculas ao verificar se há chaves duplicadas.
public static void UnionByComparerExample()
{
(string Email, string FullName)[] marketingList =
{
("Mahmoud.Doe@example.com", "Mahmoud Doe"),
("alice.smith@example.com", "Alice Smith")
};
(string Email, string FullName)[] salesList =
{
("ALICE.SMITH@EXAMPLE.COM", "Alice S."), // Duplicate email, different casing
("Sara.jones@example.com", "Sara Jones")
};
var combinedList =
marketingList.UnionBy(
salesList,
contact => contact.Email,
StringComparer.OrdinalIgnoreCase
);
foreach (var contact in combinedList)
{
Console.WriteLine($"{contact.FullName} ({contact.Email})");
}
/*
This code produces the following output:
Mahmoud Doe (Mahmoud.Doe@example.com)
Alice Smith (alice.smith@example.com)
Sara Jones (Sara.jones@example.com)
*/
}
Comentários
Esse método é implementado usando a execução adiada. O valor de retorno 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 método GetEnumerator diretamente ou usando foreach em C# ou For Each em Visual Basic.
Se comparer for null, o comparador de igualdade padrão, Defaultserá 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.
