Union(TSource) Metodo (IEnumerable(TSource), IEnumerable(TSource))
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Enumerable.Union<TSource>(IEnumerable<TSource>, IEnumerable<TSource>)

 

Produce l'unione insiemistica delle due sequenze utilizzando l'operatore di confronto di uguaglianza predefinito.

Spazio dei nomi:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IEnumerable<TSource> Union<TSource>(
	this IEnumerable<TSource> first,
	IEnumerable<TSource> second
)

Parametri

first

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

second

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

Valore restituito

Type: System.Collections.Generic.IEnumerable<TSource>

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

Parametri di tipo

TSource

Tipo degli elementi delle sequenze di input.

Exception Condition
ArgumentNullException

first o second è null.

Questo metodo viene implementato tramite esecuzione posticipata.Il valore restituito immediato è un oggetto che contiene tutte le informazioni necessarie all'esecuzione dell'azione.La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato tramite chiamata diretta al relativo metodo GetEnumerator o utilizzando l'oggetto foreach in Visual C# oppure For Each in Visual Basic.

Questo metodo esclude i duplicati dall'insieme restituito.Questo rappresenta un comportamento diverso da quello del metodo Concat<TSource>, che restituisce tutti gli elementi nelle sequenze di input inclusi i duplicati.

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

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

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

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

Per confrontare sequenze di oggetti di un tipo di dati personalizzato, è necessario implementare l'interfaccia generica IEqualityComparer<T> in una classe di aiuto.Nell'esempio di codice seguente viene illustrato come implementare questa interfaccia in un tipo di dati personalizzato e come specificare i metodi GetHashCode e Equals.

public class ProductA
{ 
    public string Name { get; set; }
    public int Code { get; set; }
}

public class ProductComparer : IEqualityComparer<ProductA>
{

    public bool Equals(ProductA x, ProductA y)
    {
        //Check whether the objects are the same object. 
        if (Object.ReferenceEquals(x, y)) return true;

        //Check whether the products' properties are equal. 
        return x != null && y != null && x.Code.Equals(y.Code) && x.Name.Equals(y.Name);
    }

    public int GetHashCode(ProductA obj)
    {
        //Get hash code for the Name field if it is not null. 
        int hashProductName = obj.Name == null ? 0 : obj.Name.GetHashCode();

        //Get hash code for the Code field. 
        int hashProductCode = obj.Code.GetHashCode();

        //Calculate the hash code for the product. 
        return hashProductName ^ hashProductCode;
    }
}

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

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

Universal Windows Platform
Disponibile da 4.5
.NET Framework
Disponibile da 3.5
Portable Class Library
Supportato in: portable .NET platforms
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra:
© 2016 Microsoft