Enumerable.SequenceEqual Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Determina se duas sequências são iguais de acordo com um comparador de igualdade.

Sobrecargas

SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Determina se duas sequências são iguais comparando os elementos usando o comparador de igualdade padrão para o tipo.
SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Determina se duas sequências são iguais, comparando seus elementos usando um IEqualityComparer<T> especificado.

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

Origem:

SequenceEqual.cs

Determina se duas sequências são iguais comparando os elementos usando o comparador de igualdade padrão para o tipo.

C#

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

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

first

IEnumerable<TSource>

Um IEnumerable<T> para comparar com second.

second

IEnumerable<TSource>

Um IEnumerable<T> para comparar com a primeira sequência.

Retornos

Boolean

true se as duas sequências de origem forem de mesmo comprimento e seus elementos correspondentes forem iguais de acordo com o comparador de igualdade padrão para seu tipo; caso contrário, false.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

Os exemplos de código a seguir demonstram como usar SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) para determinar se duas sequências são iguais. Nos dois primeiros exemplos, o método determina se as sequências comparadas contêm referências aos mesmos objetos. No terceiro e quarto exemplos, o método compara os dados reais dos objetos dentro das sequências.

Neste exemplo, as sequências são iguais.

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

O exemplo de código a seguir compara duas sequências que não são iguais. Observe que as sequências contêm dados idênticos, mas como os objetos que contêm têm referências diferentes, as sequências não são consideradas iguais.

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

Se você quiser comparar os dados reais dos objetos nas sequências em vez de apenas comparar suas referências, precisará implementar a IEqualityComparer<T> interface genérica em sua classe. O exemplo de código a seguir mostra como implementar essa interface em uma classe auxiliar e fornecer GetHashCode métodos e 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();
}

Depois de implementar essa interface, você pode usar sequências de ProductA objetos no SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) método , conforme mostrado no exemplo a seguir:

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

Comentários

O SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) método enumera as duas sequências de origem em paralelo e compara os elementos correspondentes usando o comparador de igualdade padrão para TSource, Default.

O comparador de igualdade padrão, Default, é usado para comparar valores dos tipos. Para comparar um tipo de dados personalizado, você precisa substituir os EqualsGetHashCode métodos e e, opcionalmente, implementar a IEquatable<T> interface genérica no tipo personalizado. Para obter mais informações, consulte a propriedade Default.

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

Origem:

SequenceEqual.cs

Determina se duas sequências são iguais, comparando seus elementos usando um IEqualityComparer<T> especificado.

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

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

first

IEnumerable<TSource>

Um IEnumerable<T> para comparar com second.

second

IEnumerable<TSource>

Um IEnumerable<T> para comparar com a primeira sequência.

comparer

IEqualityComparer<TSource>

Um IEqualityComparer<T> a ser usado para comparar elementos.

Retornos

Boolean

true se as duas sequências de origem tiverem o mesmo tamanho e seus elementos correspondentes forem comparados como iguais de acordo com o comparer; caso contrário, false.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

O exemplo a seguir mostra como implementar um comparador de igualdade que pode ser usado no SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) método .

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

Depois de implementar esse comparador, você pode usar sequências de Product objetos no SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) método , conforme mostrado no exemplo a seguir:

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

Comentários

O SequenceEqual<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) método enumera as duas sequências de origem em paralelo e compara os elementos correspondentes usando o especificado IEqualityComparer<T>. Se comparer for null, o comparador de igualdade padrão, Default, será usado para comparar elementos.