Enumerable.Intersect Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Produz a interseção de conjunto de duas sequências.

Sobrecargas

Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produz a interseção de conjunto de duas sequências usando o comparador de igualdade padrão para comparar os valores.
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produz a interseção de conjunto de duas sequências usando o IEqualityComparer<T> especificado para comparar os valores.

Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

Origem:

Intersect.cs

Produz a interseção de conjunto de duas sequências usando o comparador de igualdade padrão para comparar os valores.

C#

public static System.Collections.Generic.IEnumerable<TSource> Intersect<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> cujos elementos distintos que também aparecem em second serão retornados.

second

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos que também aparecem na primeira sequência serão retornados.

Retornos

IEnumerable<TSource>

Uma sequência que contém os elementos que formam a interseção de conjunto de duas sequências.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

O exemplo de código a seguir demonstra como usar Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) para retornar os elementos que aparecem em cada uma das duas sequências de inteiros.

C#

int[] id1 = { 44, 26, 92, 30, 71, 38 };
int[] id2 = { 39, 59, 83, 47, 26, 4, 30 };

IEnumerable<int> both = id1.Intersect(id2);

foreach (int id in both)
    Console.WriteLine(id);

/*
 This code produces the following output:

 26
 30
*/

Se você quiser comparar sequências de objetos de algum tipo de dados personalizado, será necessário implementar a IEquatable<T> interface genérica em uma classe auxiliar. O exemplo de código a seguir mostra como implementar essa interface em um tipo de dados personalizado e substituir 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 Intersect método , conforme mostrado no exemplo a seguir:

C#

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

C#

// Get the products from the first array
// that have duplicates in the second array.

IEnumerable<ProductA> duplicates =
    store1.Intersect(store2);

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

/*
    This code produces the following output:
    apple 9
*/

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

A interseção de dois conjuntos A e B é definida como o conjunto que contém todos os elementos de A que também aparecem em B, mas nenhum outro elemento.

Quando o objeto retornado por esse método é enumerado, Intersect produz elementos distintos que ocorrem em ambas as sequências na ordem em que aparecem em first.

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

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

Origem:

Intersect.cs

Produz a interseção de conjunto de duas sequências usando o IEqualityComparer<T> especificado para comparar os valores.

C#

public static System.Collections.Generic.IEnumerable<TSource> Intersect<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> cujos elementos distintos que também aparecem em second serão retornados.

second

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos distintos que também aparecem na primeira sequência serão retornados.

comparer

IEqualityComparer<TSource>

Um IEqualityComparer<T> para comparar valores.

Retornos

IEnumerable<TSource>

Uma sequência que contém os elementos que formam a interseção de conjunto de duas sequências.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

O exemplo a seguir mostra como implementar um comparador de igualdade que pode ser usado no Intersect 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 Intersect método , conforme mostrado no exemplo a seguir:

C#

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

Product[] store2 = { new Product { Name = "apple", Code = 9 },
                       new Product { Name = "lemon", Code = 12 } };

// Get the products from the first array
// that have duplicates in the second array.

IEnumerable<Product> duplicates =
    store1.Intersect(store2, new ProductComparer());

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

/*
    This code produces the following output:
    apple 9
*/

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

A interseção de dois conjuntos A e B é definida como o conjunto que contém todos os elementos de A que também aparecem em B, mas nenhum outro elemento.

Quando o objeto retornado por esse método é enumerado, Intersect produz elementos distintos que ocorrem em ambas as sequências na ordem em que aparecem em first.

Se comparer for null, o comparador de igualdade padrão, Default, será usado para comparar valores.