Enumerable.Distinct Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve diversos elementos de una secuencia.
Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) |
Devuelve diversos elementos de una secuencia utilizando un objeto IEqualityComparer<T> especificado para comparar los valores. |
Distinct<TSource>(IEnumerable<TSource>) |
Devuelve diversos elementos de una secuencia utilizando el comparador de igualdad predeterminado para comparar los valores. |
La secuencia de resultados no está ordenada.
- Source:
- Distinct.cs
- Source:
- Distinct.cs
- Source:
- Distinct.cs
Devuelve diversos elementos de una secuencia utilizando un objeto IEqualityComparer<T> especificado para comparar los valores.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TSource> ^ Distinct(System::Collections::Generic::IEnumerable<TSource> ^ source, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);
public static System.Collections.Generic.IEnumerable<TSource> Distinct<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource> comparer);
public static System.Collections.Generic.IEnumerable<TSource> Distinct<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, System.Collections.Generic.IEqualityComparer<TSource>? comparer);
static member Distinct : seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> seq<'Source>
<Extension()>
Public Function Distinct(Of TSource) (source As IEnumerable(Of TSource), comparer As IEqualityComparer(Of TSource)) As IEnumerable(Of TSource)
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
Secuencia de la que se van a quitar los elementos duplicados.
- comparer
- IEqualityComparer<TSource>
IEqualityComparer<T> para comparar valores.
Devoluciones
IEnumerable<T> que contiene los elementos distintos de la secuencia de origen.
Excepciones
source
es null
.
Ejemplos
En el ejemplo siguiente se muestra cómo implementar un comparador de igualdad que se puede usar en el Distinct método .
public class Product
{
public string Name { get; set; }
public int Code { get; set; }
}
// Custom comparer for the Product class
class ProductComparer : IEqualityComparer<Product>
{
// Products are equal if their names and product numbers are equal.
public bool Equals(Product x, Product y)
{
//Check whether the compared objects reference the same data.
if (Object.ReferenceEquals(x, y)) return true;
//Check whether any of the compared objects is null.
if (Object.ReferenceEquals(x, null) || Object.ReferenceEquals(y, null))
return false;
//Check whether the products' properties are equal.
return x.Code == y.Code && x.Name == y.Name;
}
// If Equals() returns true for a pair of objects
// then GetHashCode() must return the same value for these objects.
public int GetHashCode(Product product)
{
//Check whether the object is null
if (Object.ReferenceEquals(product, null)) return 0;
//Get hash code for the Name field if it is not null.
int hashProductName = product.Name == null ? 0 : product.Name.GetHashCode();
//Get hash code for the Code field.
int hashProductCode = product.Code.GetHashCode();
//Calculate the hash code for the product.
return hashProductName ^ hashProductCode;
}
}
Public Class Product
Public Property Name As String
Public Property Code As Integer
End Class
' Custom comparer for the Product class
Public Class ProductComparer
Implements IEqualityComparer(Of Product)
Public Function Equals1(
ByVal x As Product,
ByVal y As Product
) As Boolean Implements IEqualityComparer(Of Product).Equals
' Check whether the compared objects reference the same data.
If x Is y Then Return True
'Check whether any of the compared objects is null.
If x Is Nothing OrElse y Is Nothing Then Return False
' Check whether the products' properties are equal.
Return (x.Code = y.Code) AndAlso (x.Name = y.Name)
End Function
Public Function GetHashCode1(
ByVal product As Product
) As Integer Implements IEqualityComparer(Of Product).GetHashCode
' Check whether the object is null.
If product Is Nothing Then Return 0
' Get hash code for the Name field if it is not null.
Dim hashProductName =
If(product.Name Is Nothing, 0, product.Name.GetHashCode())
' Get hash code for the Code field.
Dim hashProductCode = product.Code.GetHashCode()
' Calculate the hash code for the product.
Return hashProductName Xor hashProductCode
End Function
End Class
Después de implementar este comparador, puede usar una secuencia de Product
objetos en el Distinct método , como se muestra en el ejemplo siguiente:
Product[] products = { new Product { Name = "apple", Code = 9 },
new Product { Name = "orange", Code = 4 },
new Product { Name = "apple", Code = 9 },
new Product { Name = "lemon", Code = 12 } };
// Exclude duplicates.
IEnumerable<Product> noduplicates =
products.Distinct(new ProductComparer());
foreach (var product in noduplicates)
Console.WriteLine(product.Name + " " + product.Code);
/*
This code produces the following output:
apple 9
orange 4
lemon 12
*/
Dim products() As Product =
{New Product With {.Name = "apple", .Code = 9},
New Product With {.Name = "orange", .Code = 4},
New Product With {.Name = "apple", .Code = 9},
New Product With {.Name = "lemon", .Code = 12}}
' Exclude duplicates.
Dim noduplicates = products.Distinct(New ProductComparer())
For Each product In noduplicates
Console.WriteLine(product.Name & " " & product.Code)
Next
' This code produces the following output:
'
' apple 9
' orange 4
' lemon 12
'
Comentarios
Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator
método o mediante foreach
en C# o For Each
en Visual Basic.
El Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>) método devuelve una secuencia desordenada que no contiene valores duplicados. Si comparer
es null
, el comparador de igualdad predeterminado, Default, se usa para comparar valores.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Source:
- Distinct.cs
- Source:
- Distinct.cs
- Source:
- Distinct.cs
Devuelve diversos elementos de una secuencia utilizando el comparador de igualdad predeterminado para comparar los valores.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TSource> ^ Distinct(System::Collections::Generic::IEnumerable<TSource> ^ source);
public static System.Collections.Generic.IEnumerable<TSource> Distinct<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);
static member Distinct : seq<'Source> -> seq<'Source>
<Extension()>
Public Function Distinct(Of TSource) (source As IEnumerable(Of TSource)) As IEnumerable(Of TSource)
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
Secuencia de la que se van a quitar los elementos duplicados.
Devoluciones
IEnumerable<T> que contiene los elementos distintos de la secuencia de origen.
Excepciones
source
es null
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar Distinct<TSource>(IEnumerable<TSource>) para devolver elementos distintos de una secuencia de enteros.
List<int> ages = new List<int> { 21, 46, 46, 55, 17, 21, 55, 55 };
IEnumerable<int> distinctAges = ages.Distinct();
Console.WriteLine("Distinct ages:");
foreach (int age in distinctAges)
{
Console.WriteLine(age);
}
/*
This code produces the following output:
Distinct ages:
21
46
55
17
*/
' Create a list of integers.
Dim ages As New List(Of Integer)(New Integer() _
{21, 46, 46, 55, 17, 21, 55, 55})
' Select the unique numbers in the List.
Dim distinctAges As IEnumerable(Of Integer) = ages.Distinct()
Dim output As New System.Text.StringBuilder("Distinct ages:" & vbCrLf)
For Each age As Integer In distinctAges
output.AppendLine(age)
Next
' Display the output.
Console.WriteLine(output.ToString)
' This code produces the following output:
'
' Distinct ages:
' 21
' 46
' 55
' 17
Si desea devolver elementos distintos de secuencias de objetos de algún tipo de datos personalizado, debe implementar la IEquatable<T> interfaz genérica en la clase . En el ejemplo de código siguiente se muestra cómo implementar esta interfaz en un tipo de datos personalizado y proporcionar GetHashCode métodos y Equals .
public class MyProduct : IEquatable<MyProduct>
{
public string Name { get; set; }
public int Code { get; set; }
public bool Equals(MyProduct other)
{
//Check whether the compared object is null.
if (Object.ReferenceEquals(other, null)) return false;
//Check whether the compared object references the same data.
if (Object.ReferenceEquals(this, other)) return true;
//Check whether the products' properties are equal.
return Code.Equals(other.Code) && Name.Equals(other.Name);
}
// If Equals() returns true for a pair of objects
// then GetHashCode() must return the same value for these objects.
public override int GetHashCode()
{
//Get hash code for the Name field if it is not null.
int hashProductName = Name == null ? 0 : Name.GetHashCode();
//Get hash code for the Code field.
int hashProductCode = Code.GetHashCode();
//Calculate the hash code for the product.
return hashProductName ^ hashProductCode;
}
}
Public Class Product
Implements IEquatable(Of Product)
Public Property Name As String
Public Property Code As Integer
Public Function Equals1(
ByVal other As Product
) As Boolean Implements IEquatable(Of Product).Equals
' Check whether the compared object is null.
If other Is Nothing Then Return False
' Check whether the compared object references the same data.
If Me Is Other Then Return True
' Check whether the products' properties are equal.
Return Code.Equals(other.Code) AndAlso Name.Equals(other.Name)
End Function
Public Overrides Function GetHashCode() As Integer
' Get hash code for the Name field if it is not null.
Dim hashProductName = If(Name Is Nothing, 0, Name.GetHashCode())
' Get hash code for the Code field.
Dim hashProductCode = Code.GetHashCode()
' Calculate the hash code for the product.
Return hashProductName Xor hashProductCode
End Function
End Class
Después de implementar esta interfaz, puede usar una secuencia de Product
objetos en el Distinct<TSource>(IEnumerable<TSource>) método , como se muestra en el ejemplo siguiente:
MyProduct[] products = { new MyProduct { Name = "apple", Code = 9 },
new MyProduct { Name = "orange", Code = 4 },
new MyProduct { Name = "apple", Code = 9 },
new MyProduct { Name = "lemon", Code = 12 } };
// Exclude duplicates.
IEnumerable<MyProduct> noduplicates =
products.Distinct();
foreach (var product in noduplicates)
Console.WriteLine(product.Name + " " + product.Code);
/*
This code produces the following output:
apple 9
orange 4
lemon 12
*/
Dim products() As Product =
{New Product With {.Name = "apple", .Code = 9},
New Product With {.Name = "orange", .Code = 4},
New Product With {.Name = "apple", .Code = 9},
New Product With {.Name = "lemon", .Code = 12}}
' Exclude duplicates.
Dim noduplicates = products.Distinct()
For Each product In noduplicates
Console.WriteLine(product.Name & " " & product.Code)
Next
' This code produces the following output:
'
' apple 9
' orange 4
' lemon 12
'
Comentarios
Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su GetEnumerator
método o mediante foreach
en C# o For Each
en Visual Basic.
El Distinct<TSource>(IEnumerable<TSource>) método devuelve una secuencia desordenada que no contiene valores duplicados. Usa el comparador de igualdad predeterminado, Default, para comparar valores.
En la sintaxis de la expresión de consulta de Visual Basic, una Distinct
cláusula se traduce en una invocación de Distinct.
El comparador de igualdad predeterminado, Default, se usa para comparar valores de los tipos que implementan la IEquatable<T> interfaz genérica. Para comparar un tipo de datos personalizado, debe implementar esta interfaz y proporcionar sus propios GetHashCode métodos y Equals para el tipo.
Para obtener un ejemplo que usa IEqualityComparer<T> para definir un comparador personalizado, vea Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>).
Consulte también
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: