Enumerable.Union Metodo

Definizione

Spazio dei nomi:

System.Linq

Assembly:

System.Linq.dll

Produce l'unione di set di due sequenze.

Overload

Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)	Produce l'unione di set di due sequenze usando l'operatore di confronto di uguaglianza predefinito.
Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>)	Produce l'unione set di due sequenze utilizzando un IEqualityComparer<T>specificato.

Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

Origine:

Union.cs

Produce l'unione di set di due sequenze usando l'operatore di confronto di uguaglianza predefinito.

C#

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

Parametri di tipo

TSource

Tipo degli elementi delle sequenze di input.

Parametri

first

IEnumerable<TSource>

Oggetto IEnumerable<T> i cui elementi distinti formano il primo set per l'unione.

second

IEnumerable<TSource>

Oggetto IEnumerable<T> i cui elementi distinti formano il secondo set per l'unione.

Restituisce

IEnumerable<TSource>

Un IEnumerable<T> che contiene gli elementi di entrambe le sequenze di input, esclusi i duplicati.

Eccezioni

ArgumentNullException

first o second è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) per ottenere l'unione di due sequenze di interi.

C#

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

Se si desidera confrontare sequenze di oggetti di un tipo di dati personalizzato, è necessario implementare l'interfaccia IEquatable<T> generica in una classe helper. Nell'esempio di codice seguente viene illustrato come implementare questa interfaccia in un tipo di dati personalizzato ed eseguire l'override dei metodi GetHashCode 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();
}

Dopo aver implementato questa interfaccia, è possibile usare sequenze di oggetti ProductA nel metodo Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>), come illustrato nell'esempio seguente:

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

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando direttamente il relativo metodo GetEnumerator o usando foreach in C# o For Each in Visual Basic.

Questo metodo esclude i duplicati dal set restituito. Si tratta di un comportamento diverso rispetto al metodo Concat, che restituisce tutti gli elementi nelle sequenze di input, inclusi i duplicati.

L'operatore di confronto di uguaglianza predefinito, Default, viene usato per confrontare i valori dei tipi che implementano l'interfaccia generica IEqualityComparer<T>. Per confrontare un tipo di dati personalizzato, è necessario implementare questa interfaccia e fornire metodi personalizzati GetHashCode e Equals per il tipo.

Quando l'oggetto restituito da questo metodo viene enumerato, Union enumera first e second in tale ordine e restituisce ogni elemento che non è già stato restituito.

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

Origine:

Union.cs

Produce l'unione set di due sequenze utilizzando un IEqualityComparer<T>specificato.

C#

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

Parametri di tipo

TSource

Tipo degli elementi delle sequenze di input.

Parametri

first

IEnumerable<TSource>

Oggetto IEnumerable<T> i cui elementi distinti formano il primo set per l'unione.

second

IEnumerable<TSource>

Oggetto IEnumerable<T> i cui elementi distinti formano il secondo set per l'unione.

comparer

IEqualityComparer<TSource>

IEqualityComparer<T> per confrontare i valori.

Restituisce

IEnumerable<TSource>

Un IEnumerable<T> che contiene gli elementi di entrambe le sequenze di input, esclusi i duplicati.

Eccezioni

ArgumentNullException

first o second è null.

Esempio

Nell'esempio seguente viene illustrato come implementare un operatore di confronto di uguaglianza che può essere usato nel metodo Union.

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

Dopo aver implementato questo operatore di confronto, è possibile usare sequenze di oggetti Product nel metodo Union, come illustrato nell'esempio seguente:

C#

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

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

//Get the products from the both arrays
//excluding duplicates.

IEnumerable<Product> union =
  store10.Union(store20, new ProductComparer());

foreach (Product product in union)
    Console.WriteLine(product.Name + " " + product.Code);

/*
    This code produces the following output:

    apple 9
    orange 4
    lemon 12
*/

Commenti

Questo metodo viene implementato usando l'esecuzione posticipata. Il valore restituito immediato è un oggetto che archivia tutte le informazioni necessarie per eseguire l'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato chiamando direttamente il relativo metodo GetEnumerator o usando foreach in C# o For Each in Visual Basic.

Se comparer è null, l'operatore di confronto di uguaglianza predefinito, Default, viene usato per confrontare i valori.

Quando l'oggetto restituito da questo metodo viene enumerato, Union enumera first e second in tale ordine e restituisce ogni elemento che non è già stato restituito.

Il metodo Concat differisce dal metodo Union perché il metodo Concat restituisce tutti gli elementi nelle sequenze di input inclusi i duplicati, mentre Union restituisce solo valori univoci.

Vedi anche

• metodo unionby