Enumerable.Intersect Metoda

Definice

Obor názvů:

System.Linq

Sestavení:

System.Linq.dll

Vytvoří množinu průniku dvou sekvencí.

Přetížení

Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Vytvoří množinu průniku dvou sekvencí pomocí výchozího porovnávače rovnosti k porovnání hodnot.
Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Vytvoří množinu průniku dvou sekvencí pomocí zadané IEqualityComparer<T> k porovnání hodnot.

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

Zdroj:

Intersect.cs

Vytvoří množinu průniku dvou sekvencí pomocí výchozího porovnávače rovnosti k porovnání hodnot.

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

Parametry typu

TSource

Typ prvků vstupních sekvencí.

Parametry

first

IEnumerable<TSource>

Vrátí IEnumerable<T> se jedinečný prvek, který se zobrazí také v second .

second

IEnumerable<TSource>

Vrátí IEnumerable<T> se jedinečný prvek, který se také objeví v první sekvenci.

Návraty

IEnumerable<TSource>

Sekvence, která obsahuje prvky, které tvoří množinu průniku dvou sekvencí.

Výjimky

ArgumentNullException

first nebo second je null.

Příklady

Následující příklad kódu ukazuje, jak použít Intersect<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) k vrácení elementů, které se zobrazí v každé ze dvou sekvencí celých čísel.

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

Pokud chcete porovnat sekvence objektů nějakého vlastního datového typu, musíte implementovat IEquatable<T> obecné rozhraní v pomocné třídě. Následující příklad kódu ukazuje, jak implementovat toto rozhraní ve vlastním datovém typu a přepsání GetHashCode a Equals metody.

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

Po implementaci tohoto rozhraní můžete v Intersect metodě použít sekvence ProductA objektů, jak je znázorněno v následujícím příkladu:

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

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator metody přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Průsečík dvou množin A a B je definován jako množina, která obsahuje všechny prvky A, které se také zobrazují v jazyce B, ale žádné jiné prvky.

Při výčtu objektu Intersect vráceného touto metodou poskytuje jedinečné prvky, které se vyskytují v obou sekvencích v pořadí, ve kterém se zobrazují v first.

Výchozí porovnávače rovnosti , Defaultse používá k porovnání hodnot typů. Pokud chcete porovnat vlastní datový typ, musíte přepsat Equals metody a GetHashCode a volitelně implementovat IEquatable<T> obecné rozhraní ve vlastním typu. Další informace najdete ve Default vlastnosti.

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

Zdroj:

Intersect.cs

Vytvoří množinu průniku dvou sekvencí pomocí zadané IEqualityComparer<T> k porovnání hodnot.

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

Parametry typu

TSource

Typ prvků vstupních sekvencí.

Parametry

first

IEnumerable<TSource>

Vrátí IEnumerable<T> se jedinečný prvek, který se zobrazí také v second .

second

IEnumerable<TSource>

Vrátí IEnumerable<T> se jedinečný prvek, který se také objeví v první sekvenci.

comparer

IEqualityComparer<TSource>

An IEqualityComparer<T> pro porovnání hodnot.

Návraty

IEnumerable<TSource>

Sekvence, která obsahuje prvky, které tvoří množinu průniku dvou sekvencí.

Výjimky

ArgumentNullException

first nebo second je null.

Příklady

Následující příklad ukazuje, jak implementovat porovnávací nástroj rovnosti, který lze použít v Intersect metodě.

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

Po implementaci tohoto porovnávače můžete v Intersect metodě použít posloupnosti Product objektů, jak je znázorněno v následujícím příkladu:

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

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator metody přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Průsečík dvou množin A a B je definován jako množina, která obsahuje všechny prvky A, které se také zobrazují v jazyce B, ale žádné jiné prvky.

Při výčtu objektu Intersect vráceného touto metodou poskytuje jedinečné prvky, které se vyskytují v obou sekvencích v pořadí, ve kterém se zobrazují v first.

Pokud comparer je null, použije se k porovnání hodnot výchozí porovnávače Defaultrovnosti.