Enumerable.GroupJoin<TOuter, TInner, TKey, TResult>, méthode (IEnumerable<TOuter>, IEnumerable<TInner>, Func<TOuter, TKey>, Func<TInner, TKey>, Func<TOuter, IEnumerable<TInner>, TResult>, IEqualityComparer<TKey>)

public static IEnumerable<TResult> GroupJoin<TOuter, TInner, TKey, TResult>(
	this IEnumerable<TOuter> outer,
	IEnumerable<TInner> inner,
	Func<TOuter, TKey> outerKeySelector,
	Func<TInner, TKey> innerKeySelector,
	Func<TOuter, IEnumerable<TInner>, TResult> resultSelector,
	IEqualityComparer<TKey> comparer
)

Remarque sur l'utilisation

Cette méthode est implémentée par exécution différée. La valeur de retour immédiate est un objet qui stocke toutes les informations requises pour réaliser 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 par l'appel de sa méthode GetEnumerator directement, soit à l'aide de foreach dans Visual C# ou de For Each dans Visual Basic.

Si comparer est null, le comparateur d'égalité par défaut Default est utilisé pour hacher et comparer les clés.

GroupJoin produit des résultats hiérarchiques, ce qui signifie que les éléments de outer sont associés à des collections d'éléments correspondants de inner. GroupJoin vous permet de baser vos résultats sur un ensemble complet de correspondances pour chaque élément de outer.

Remarque
Si aucun élément corrélé n'existe dans inner pour un élément spécifique de outer, la séquence de correspondances pour cet élément sera vide mais continuera d'apparaître dans les résultats.

La fonction resultSelector n'est appelée qu'une seule fois pour chaque élément outer avec une collection de tous les éléments inner qui correspondent à l'élément outer. Cette méthode est différente de la méthode Join, dans laquelle la fonction de sélection de résultat est appelée sur des paires qui contiennent un élément de outer et un élément de inner.

GroupJoin conserve l'ordre des éléments de outer ainsi que l'ordre des éléments correspondants de inner pour chaque élément de outer.

GroupJoin n'a pas d'équivalent direct en termes de base de données relationnelle traditionnelle. Toutefois, cette méthode implémente un sur-ensemble de jointures internes et de jointures externes gauches. Ces deux opérations peuvent être écrites en termes de jointure groupée. Consultez Opérations de jointure.

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources