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

Enumerable.Union<TSource> 方法 (IEnumerable<TSource>, IEnumerable<TSource>)

 

通过使用默认的相等比较器生成的两个序列的并集。

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

public static IEnumerable<TSource> Union<TSource>(
	this IEnumerable<TSource> first,
	IEnumerable<TSource> second
)

参数

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

IEnumerable<T> 的非重复元素构成并集的第一个集。

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

IEnumerable<T> 的非重复元素构成并集的第二个。

返回值

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

IEnumerable<T> ,其中包含非重复这两个输入序列中的元素。

类型参数

TSource

输入序列中的元素的类型。

Exception Condition
ArgumentNullException

firstsecondnull

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

此方法从结果集中排除重复项。 这是到不同的行为 Concat<TSource> 方法,包括重复项的输入序列中返回所有元素。

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

当此方法返回的对象枚举时, Union<TSource> 枚举 firstsecond 按此顺序并生成尚未生成每个元素。

下面的代码示例演示如何使用 Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) 以获取两个整数的序列的并集。

int[] ints1 = { 5, 3, 9, 7, 5, 9, 3, 7 };
int[] ints2 = { 8, 3, 6, 4, 4, 9, 1, 0 };

IEnumerable<int> union = ints1.Union(ints2);

foreach (int num in union)
{
    Console.Write("{0} ", num);
}

/*
 This code produces the following output:

 5 3 9 7 8 6 4 1 0
*/

如果您想要比较的自定义数据类型的对象的序列,则必须实现 IEqualityComparer<T> helperclass 中的泛型接口。 下面的代码示例演示如何在自定义数据类型中实现此接口,并提供 GetHashCodeEquals 方法。

public class ProductA
{ 
    public string Name { get; set; }
    public int Code { get; set; }
}

public class ProductComparer : IEqualityComparer<ProductA>
{

    public bool Equals(ProductA x, ProductA y)
    {
        //Check whether the objects are the same object. 
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether the products' properties are equal. 
        return x != null && y != null && x.Code.Equals(y.Code) && x.Name.Equals(y.Name);
    }

    public int GetHashCode(ProductA obj)
    {
        //Get hash code for the Name field if it is not null. 
        int hashProductName = obj.Name == null ? 0 : obj.Name.GetHashCode();

        //Get hash code for the Code field. 
        int hashProductCode = obj.Code.GetHashCode();

        //Calculate the hash code for the product. 
        return hashProductName ^ hashProductCode;
    }
}

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

ProductA[] store1 = { new ProductA { Name = "apple", Code = 9 }, 
                       new ProductA { Name = "orange", Code = 4 } };

ProductA[] store2 = { new ProductA { Name = "apple", Code = 9 }, 
                       new ProductA { Name = "lemon", Code = 12 } };
//Get the products from the both arrays
//excluding duplicates.

IEnumerable<ProductA> union =
  store1.Union(store2);

foreach (var product in union)
    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 起可用
返回页首
显示: