本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

Enumerable.Distinct<TSource> 方法 (IEnumerable<TSource>)

 

通过使用的默认相等比较器对值进行比较从序列返回非重复元素。

命名空间:   System.Linq
程序集:  System.Core(位于 System.Core.dll)

public static IEnumerable<TSource> Distinct<TSource>(
	this IEnumerable<TSource> source
)

参数

source
Type: System.Collections.Generic.IEnumerable<TSource>

要从中移除重复元素的序列。

返回值

Type: System.Collections.Generic.IEnumerable<TSource>

IEnumerable<T> ,其中包含源序列中的非重复元素。

类型参数

TSource

中的元素的类型 source

Exception Condition
ArgumentNullException

sourcenull

此方法实现通过使用延迟的执行。 最接近的返回值是指存储执行的操作所需的所有信息的对象。 此方法所表示的查询不执行之前调用枚举的对象及其 GetEnumerator 方法直接或通过使用 foreach 中 Visual C# 或 For Each 中 Visual Basic。

Distinct<TSource>(IEnumerable<TSource>) 方法将返回不包含重复值的无序的序列。 它使用默认的相等比较, Default, 、 对值进行比较。

在 Visual Basic 查询表达式语法中, Distinct 子句转换为的一个调用 Distinct<TSource>

默认的相等比较, Default, ,用于比较的类型的实现值 IEquatable<T> 泛型接口。 若要比较自定义数据类型,您需要实现此接口,并提供您自己 GetHashCodeEquals 类型的方法。

有关使用示例, IEqualityComparer<T>若要定义自定义比较器,请参阅 Distinct<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)

下面的代码示例演示如何使用 Distinct<TSource>(IEnumerable<TSource>) 要返回的整数序列中非重复元素。

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
*/

如果你想要从某个自定义数据类型的对象的序列中返回的非重复元素,则必须实现 IEquatable<T> 类中的泛型接口。 下面的代码示例演示如何在自定义数据类型中实现此接口,并提供 GetHashCodeEquals 方法。

public class Product : IEquatable<Product>
{
    public string Name { get; set; }
    public int Code { get; set; }

    public bool Equals(Product 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;
    }
}

实现此接口后,您可以使用一系列 Product 中的对象 Distinct<TSource>(IEnumerable<TSource>) 方法,如下面的示例中所示。

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

foreach (var product in noduplicates)
    Console.WriteLine(product.Name + " " + product.Code);

/*
    This code produces the following output:
    apple 9 
    orange 4
    lemon 12
*/

通用 Windows 平台
自 8 起可用
.NET Framework
自 3.5 起可用
可移植类库
可移植 .NET 平台 中受支持
Silverlight
自 2.0 起可用
Windows Phone Silverlight
自 7.0 起可用
Windows Phone
自 8.1 起可用
返回页首
显示: