Enumerable.SequenceEqual 方法

定義

命名空間:

System.Linq

組件:

System.Linq.dll

根據相等比較子，判斷兩個序列是否相等。

多載

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	使用項目之型別的預設相等比較子來比較項目，以判斷兩個序列是否相等。
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	使用指定的 IEqualityComparer<T> 來比較項目，以判斷兩個序列是否相等。

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

來源:

SequenceEqual.cs

使用項目之型別的預設相等比較子來比較項目，以判斷兩個序列是否相等。

C#

public static bool SequenceEqual<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

類型參數

TSource

輸入序列之項目的類型。

參數

first

IEnumerable<TSource>

要與 second 比較的 IEnumerable<T>。

second

IEnumerable<TSource>

要與第一個序列比較的 IEnumerable<T>。

傳回

Boolean

如果根據其型別的預設相等比較子判斷，兩個來源序列的長度相等，而且其對應項目也相等，則為 true，否則為 false。

例外狀況

ArgumentNullException

first 或 second 為 null。

範例

下列程式代碼範例示範如何使用 SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) 來判斷兩個序列是否相等。 在前兩個範例中，方法會判斷比較序列是否包含相同對象的參考。 在第三個和第四個範例中，方法會比較序列中對象的實際數據。

在此範例中，序列相等。

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void SequenceEqualEx1()
{
    Pet pet1 = new Pet { Name = "Turbo", Age = 2 };
    Pet pet2 = new Pet { Name = "Peanut", Age = 8 };

    // Create two lists of pets.
    List<Pet> pets1 = new List<Pet> { pet1, pet2 };
    List<Pet> pets2 = new List<Pet> { pet1, pet2 };

    bool equal = pets1.SequenceEqual(pets2);

    Console.WriteLine(
        "The lists {0} equal.",
        equal ? "are" : "are not");
}

/*
 This code produces the following output:

 The lists are equal.
*/

下列程式代碼範例會比較兩個不相等的序列。 請注意，序列包含相同的數據，但由於其包含的物件具有不同的參考，因此序列不會被視為相等。

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void SequenceEqualEx2()
{
    Pet pet1 = new Pet() { Name = "Turbo", Age = 2 };
    Pet pet2 = new Pet() { Name = "Peanut", Age = 8 };

    // Create two lists of pets.
    List<Pet> pets1 = new List<Pet> { pet1, pet2 };
    List<Pet> pets2 =
        new List<Pet> { new Pet { Name = "Turbo", Age = 2 },
                        new Pet { Name = "Peanut", Age = 8 } };

    bool equal = pets1.SequenceEqual(pets2);

    Console.WriteLine("The lists {0} equal.", equal ? "are" : "are not");
}

/*
 This code produces the following output:

 The lists are not equal.
*/

如果您想要比較序列中對象的實際數據，而不只是比較其參考，您必須在類別中實 IEqualityComparer<T> 作泛型介面。 下列程式代碼範例示範如何在協助程式類別中實作這個介面，並提供 GetHashCode 和 Equals 方法。

C#

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

    public bool Equals(ProductA other)
    {
        if (other is null)
            return false;

        return this.Name == other.Name && this.Code == other.Code;
    }

    public override bool Equals(object obj) => Equals(obj as ProductA);
    public override int GetHashCode() => (Name, Code).GetHashCode();
}

實作此介面之後，您可以在 方法中使用SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)物件序列ProductA，如下列範例所示：

C#

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

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

bool equalAB = storeA.SequenceEqual(storeB);

Console.WriteLine("Equal? " + equalAB);

/*
    This code produces the following output:

    Equal? True
*/

備註

方法SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)會以平行方式列舉兩個來源序列，並使用的預設相等比較子來TSourceDefault比較對應的專案。

默認相等比較子 Default是用來比較型別的值。 若要比較自定義數據類型，您必須覆寫 Equals 和 GetHashCode 方法，並選擇性地在自定義類型中實 IEquatable<T> 作泛型介面。 如需詳細資訊，請參閱 Default 屬性 (Property)。

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)

來源:

SequenceEqual.cs

使用指定的 IEqualityComparer<T> 來比較項目，以判斷兩個序列是否相等。

C#

public static bool SequenceEqual<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, System.Collections.Generic.IEqualityComparer<TSource>? comparer);

類型參數

TSource

輸入序列之項目的類型。

參數

first

IEnumerable<TSource>

要與 second 比較的 IEnumerable<T>。

second

IEnumerable<TSource>

要與第一個序列比較的 IEnumerable<T>。

comparer

IEqualityComparer<TSource>

用來比較項目的 IEqualityComparer<T>。

傳回

Boolean

如果根據 comparer 判斷，兩個來源序列的長度相等，而且其對應項目的比較也相等，則為 true，否則為 false。

例外狀況

ArgumentNullException

first 或 second 為 null。

範例

下列範例示範如何實作可用於 方法的 SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 相等比較子。

C#

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;
    }
}

實作這個比較子之後，您可以在 方法中使用SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)物件序列Product，如下列範例所示：

C#

Product[] storeA = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "orange", Code = 4 } };

Product[] storeB = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "orange", Code = 4 } };

bool equalAB = storeA.SequenceEqual(storeB, new ProductComparer());

Console.WriteLine("Equal? " + equalAB);

/*
    This code produces the following output:

    Equal? True
*/

備註

方法 SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) 會以平行方式列舉兩個來源序列，並使用指定的 IEqualityComparer<T>來比較對應的專案。 如果 為 comparernull，則會使用預設相等比較子 Default來比較專案。