Enumerable.UnionBy Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Surcharges

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)	Produit l’union définie de deux séquences en fonction d’une fonction de sélecteur de clé spécifiée.
UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Produit l’union définie de deux séquences en fonction d’une fonction de sélecteur de clé spécifiée.

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>)

Source:

Union.cs

Produit l’union définie de deux séquences en fonction d’une fonction de sélecteur de clé spécifiée.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ UnionBy(System::Collections::Generic::IEnumerable<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second, Func<TSource, TKey> ^ keySelector);

public static System.Collections.Generic.IEnumerable<TSource> UnionBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second, Func<TSource,TKey> keySelector);

static member UnionBy : seq<'Source> * seq<'Source> * Func<'Source, 'Key> -> seq<'Source>

<Extension()>
Public Function UnionBy(Of TSource, TKey) (first As IEnumerable(Of TSource), second As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IEnumerable(Of TSource)

Paramètres de type

TSource

Type des éléments des séquences d'entrée.

TKey

Type de clé par lequel identifier les éléments.

Paramètres

first

IEnumerable<TSource>

IEnumerable<T> dont les éléments distincts constituent le premier jeu de l'union.

second

IEnumerable<TSource>

IEnumerable<T> dont les éléments distincts constituent le second jeu de l'union.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire la clé de chaque élément.

Retours

IEnumerable<TSource>

IEnumerable<T> qui contient les éléments des deux séquences d'entrée, à l'exception des éléments en double.

Exceptions

ArgumentNullException

first ou second est null.

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

Le comparateur d’égalité par défaut, Default, est utilisé pour comparer les valeurs.

Lorsque l’objet retourné par cette méthode est énuméré, UnionBy énumère first et second dans cet ordre et génère chaque élément qui n’a pas encore été généré.

Voir aussi

• Exemples Union et UnionBy

UnionBy<TSource,TKey>(IEnumerable<TSource>, IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Source:

Union.cs

Produit l’union définie de deux séquences en fonction d’une fonction de sélecteur de clé spécifiée.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ UnionBy(System::Collections::Generic::IEnumerable<TSource> ^ first, System::Collections::Generic::IEnumerable<TSource> ^ second, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);

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

static member UnionBy : seq<'Source> * seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IEqualityComparer<'Key> -> seq<'Source>

<Extension()>
Public Function UnionBy(Of TSource, TKey) (first As IEnumerable(Of TSource), second As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IEqualityComparer(Of TKey)) As IEnumerable(Of TSource)

Paramètres de type

TSource

Type des éléments des séquences d'entrée.

TKey

Type de clé par lequel identifier les éléments.

Paramètres

first

IEnumerable<TSource>

IEnumerable<T> dont les éléments distincts constituent le premier jeu de l'union.

second

IEnumerable<TSource>

IEnumerable<T> dont les éléments distincts constituent le second jeu de l'union.

keySelector

Func<TSource,TKey>

Fonction permettant d'extraire la clé de chaque élément.

comparer

IEqualityComparer<TKey>

IEqualityComparer<T> pour comparer les valeurs.

Retours

IEnumerable<TSource>

IEnumerable<T> qui contient les éléments des deux séquences d'entrée, à l'exception des éléments en double.

Exceptions

ArgumentNullException

first ou second est null.

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

Si comparer est null, le comparateur d’égalité par défaut, Default, est utilisé pour comparer les valeurs.

Lorsque l’objet retourné par cette méthode est énuméré, UnionBy énumère first et second dans cet ordre et génère chaque élément qui n’a pas encore été généré.

Voir aussi

• Exemples Union et UnionBy