Hoje vou apresentar os novos métodos DistinctBy e ExceptBy da LINQ que operam com conjuntos e estão  disponíveis a partir do .NET 6.

As operações de conjunto na LINQ referem-se a operações de consulta que geram um conjunto de resultados baseado na presença ou ausência de elementos equivalentes dentro da mesma coleção ou de coleções ou conjuntos separados.

Os métodos usados até o momento para realizar estas operações são :

• Distinct – Remove os valores duplicados de uma coleção;
• Except – Retorna a diferença de conjunto, ou seja, os elementos de uma coleção que não aparecem em uma segunda coleção
• Intercept – Retorna a intersecção de conjunto, ou seja, os elementos que aparecem em cada uma das duas coleções~;
• Union – Retorna a união de conjunto, ou seja, os elementos únicos que aparecem em qualquer das duas coleções

Esses métodos realizam operações em conjuntos em comparação com outros conjuntos de valores.

A partir do NET 6 foram incluídos os seguintes métodos para operações de conjunto :

• DistinctBy – Aceita um KeySelector usado como discriminador comparativo do tipo origem;
• ExceptBy – Aceita duas sequências de tipos heterogêneos e um KeySelector que é do mesmo tipo para as duas sequências sendo usado como discriminador comparativo do tipo origem;
• InterceptBy – Aceita duas sequências dos tipos heterogêneos e um keySelector que é usado como o discriminador comparativo do tipo da segunda coleção;
• UnionBy – Aceita duas sequências do mesmo tipo e uma keySelector que é é usado como o discriminador comparativo do tipo de origem;

Eles possuem o mesmo objetivo dos métodos anteriores com a diferença de que operam em objetos complexos e que  eles utilizam uma chave de seleção(KeySelector) usada como um discriminador comparativo para realizar as respectivas operações.

Assim, esses novos métodos utilizam uma propriedade/objeto que deve fazer parte das coleções envolvidas, dispensando assim implementações baseadas na interface IEqualityComparer que eram requeridas por extensões LINQ mais antigas como Union e Intersect.

Neste artigo iremos apresentar um exemplo dos dois primeiros métodos para ilustrar o seu funcionamento.

Usando o método DistinctBy

Vamos criar um projeto Console (.NET Core) no NET 6 chamado LINQ_DistinctBy.

No projeto criado vamos abrir a classe Program e definir um tipo record Aluno:

A seguir vamos criar uma lista de alunos :

Para mostrar a atuação do método DistinctBy vamos obter uma lista de alunos com idades únicas ou distintas. Para isso vamos definir a seguinte consulta LINQ

var alunosComIdadesDistintas = alunos.DistinctBy(x => x.Idade);

Aqui usamos o método DistinctBy e definimos a propriedade Idade como a chave de seleção usada como critério para obter a lista de alunos com idades únicas.

Podemos inclusive realizar a ordenação do resultado :

var alunosComIdadesDistintas = alunos.DistinctBy(x => x.Idade).OrderBy(x=> x.Nome);

A seguir podemos percorrer  o resultado obtido, que é um IEnumerable<T>, e exibir os nomes dos alunos:

foreach(var aluno in alunosComIdadesDistintas)
      Console.WriteLine($"Aluno {aluno.Nome} tem {aluno.Idade} anos");

O código completo do projeto é dado a seguir:

Obs: Aqui usamos o recurso das instruções de nível superior

Executando o projeto teremos o resultado a abaixo:

Usando o método ExceptBy

Vamos criar outro projeto Console (.NET Core) no NET 6 chamado LINQ_ExceptBy.

No projeto criado vamos abrir a classe Program e definir um tipo record Planeta:

A seguir vamos criar uma lista de planetas contendo todos os planetas do sistema solar:

Vamos criar também outra lista de planetas gasosos (jovianos) :

Feito isso, o nosso objetivo será obter uma lista dos planetas com exceção dos planetas jovianos. Para isso usamos o método Exceptby onde :

1 - Vamos definir a coleção que contem os elementos que desejamos retirar da primeira coleção , ou seja da coleção planetas, e, aplicar o método ExceptBy;
2 - A seguir vamos definir a chave de seleção que é a propriedade Nome;

var planetasExcetoJovianos = planetas.ExceptBy(jovianos.Select(p => p.Nome), p => p.Nome).OrderBy(x=> x.Nome);

Com isso vamos obter todos os planetas, exceto aqueles planetas cujo nome identificam um planeta joviano ou gasoso,
e, ainda estamos ordenando o resultado.

O código completo do projeto é dado a seguir:

Obs: Aqui usamos o recurso das instruções de nível superior

Executando o projeto teremos o seguinte resultado:

Com o uso destes métodos temos um código mais sucinto e legível e que realiza a tarefa proposta em apenas uma etapa.

Na próxima parte do artigo veremos os métodos : IntercepBy e UnionBy

Pegue o código dos dois projetos aqui : linq1.zip

"Deus "retribuirá a cada um conforme o seu procedimento".
Ele dará vida eterna aos que, persistindo em fazer o bem, buscam glória, honra e imortalidade."
Romanos 2:6,7

E estamos conversados.

Referências:

• Jose C Macoratti (@macorati) | Twitter

• C# - Lendo e escrevendo em arquivos textos e binários

• C# - Entendo o I/O na plataforma .NET

• C# - Fluxo assíncrono ou async streams

• C#- Apresentando Streams assíncronos

• NET 6 - Novo template do projeto Console

• C# 9.0 - Target-typed com expressões new

• .NET 6 - Global Using

• .NET 6 - Usando apenas Data (DateOnly)

• .NET 6 - LINQ - Usando o método Chunk

José Carlos Macoratti