HOWTO · Csharp
Obtenga una lista distinta basada en una o más propiedades en C#
Este artículo tratará los aspectos básicos del uso de la función Distinct() en LINQ y la obtención de una lista distinta basada en una o más propiedades en C#.
En esta página
Distinct() en LINQ elimina los valores duplicados según la igualdad definida para el tipo de elemento. En una clase como CAR, no compara automáticamente propiedades seleccionadas, como Id o Color. Para conservar un objeto por cada clave de propiedad, agrupa los elementos por esa clave y selecciona un objeto de cada grupo.
Los ejemplos usan tres coches. Los dos primeros comparten un ID, pero tienen colores distintos; el segundo y el tercero comparten el color. El código siguiente es un ejemplo autónomo. (C#)
Comprender la igualdad entre objetos y elegir una clave
Elige una clave que corresponda a lo que significa «distinto» para la tarea. Agrupar por Id considera duplicados los coches con el mismo ID, mientras que agrupar por (Id, Color) solo considera duplicados los que coinciden en ambos valores. GroupBy() crea grupos a partir de la clave seleccionada y Select() proyecta un objeto representativo de cada grupo.
Agrupar por una propiedad y conservar un elemento de cada grupo
Este programa completo agrupa por Id y conserva el primer coche de cada grupo. Como los dos primeros coches tienen el ID 4, el resultado contiene el primer coche y el que tiene el ID 6.
Ejecuta este ejemplo. El código y las etiquetas o salidas visibles de esta sección permanecen en inglés:
using System;
using System.Linq;
class Program
{
sealed class CAR
{
public int Id { get; private set; }
public string Color { get; private set; }
public CAR(int id, string color)
{
Id = id;
Color = color;
}
}
static void Main()
{
CAR[] cars = new CAR[]
{
new CAR(4, "red"),
new CAR(4, "blue"),
new CAR(6, "blue")
};
System.Collections.Generic.IEnumerable<CAR> distinctCars = cars
.GroupBy(car => car.Id)
.Select(group => group.First());
foreach (CAR car in distinctCars)
{
Console.WriteLine(car.Id + " " + car.Color);
}
}
}
4 red
6 blue
First() conserva el primer objeto encontrado para cada clave. Si cambia el orden de entrada, también puede cambiar el objeto representativo del grupo. La clave es Id; el valor seleccionado sigue siendo un objeto CAR, por lo que sus demás propiedades siguen disponibles.
Agrupar por varias propiedades con una clave compuesta
Cuando tanto el ID como el color determinan la unicidad, usa una tupla como clave de agrupación. Los pares de este ejemplo son (4, red), (4, blue) y (6, blue), así que los tres coches pertenecen a grupos distintos. Este programa completo usa los mismos valores de cars que el ejemplo anterior y selecciona un coche por cada par (Id, Color).
Ejecuta este ejemplo. El código y las etiquetas o salidas visibles de esta sección permanecen en inglés:
using System;
using System.Linq;
class Program
{
sealed class CAR
{
public int Id { get; private set; }
public string Color { get; private set; }
public CAR(int id, string color)
{
Id = id;
Color = color;
}
}
static void Main()
{
CAR[] cars = new CAR[]
{
new CAR(4, "red"),
new CAR(4, "blue"),
new CAR(6, "blue")
};
var distinctCars = cars
.GroupBy(car => (car.Id, car.Color))
.Select(group => group.First());
foreach (CAR car in distinctCars)
{
Console.WriteLine("(" + car.Id + ", " + car.Color + ")");
}
}
}
(4, red)
(4, blue)
(6, blue)
Una propiedad declarada como int no puede ser nula, así que no debe compararse con null. Si una propiedad de clave es anulable en tu modelo, trata los valores nulos según el tipo declarado de esa propiedad y la regla de agrupación prevista.
Usar DistinctBy para obtener un resultado basado en una clave
DistinctBy expresa directamente la misma intención de seleccionar por clave cuando está disponible en las API de LINQ que usa tu proyecto. Por ejemplo, cars.DistinctBy(car => car.Id) selecciona un coche por cada ID. Si ambas propiedades determinan la unicidad, usa una clave compuesta como car => (car.Id, car.Color). Es una alternativa a la agrupación; para estos ejemplos no hace falta ningún método de extensión personalizado.
Elegir First o FirstOrDefault para secuencias vacías
First() devuelve el primer elemento y lanza una excepción si la secuencia está vacía. En cambio, FirstOrDefault() devuelve el valor predeterminado del tipo de elemento cuando no hay un primer elemento. Para un tipo de referencia como CAR, ese valor es null; para un tipo de valor como int, es 0.
Es posible que debas comprobar ese valor predeterminado antes de usarlo. FirstOrDefault() no evita los errores relacionados con valores nulos cuando la referencia devuelta es null. Elígelo cuando sea posible que la secuencia esté vacía y gestiona adecuadamente el valor predeterminado devuelto; usa First() cuando una secuencia vacía deba tratarse como un error.
Escribir la consulta de agrupación con sintaxis de consulta
La sintaxis de consulta permite agrupar por clave y seleccionar el primer elemento de cada grupo: var distinctCars = from car in cars group car by car.Id into carGroup select carGroup.First();.
Para una clave compuesta, usa group car by (car.Id, car.Color). Ambas formas conservan un objeto representativo por cada clave. Elige la sintaxis de métodos o la de consulta según cuál deje más claro qué clave se usa y qué resultado se selecciona.