Queryable.Union Méthode

Définition

Produit l'union définie de deux séquences.Produces the set union of two sequences.

Surcharges

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

Produit l'union de deux séquences à l'aide du comparateur d'égalité par défaut.Produces the set union of two sequences by using the default equality comparer.

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

Produit l'union de deux séquences à l'aide d'un IEqualityComparer<T> spécifié.Produces the set union of two sequences by using a specified IEqualityComparer<T>.

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

Produit l'union de deux séquences à l'aide du comparateur d'égalité par défaut.Produces the set union of two sequences by using the default equality comparer.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Union(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2);
public static System.Linq.IQueryable<TSource> Union<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2);
static member Union : System.Linq.IQueryable<'Source> * seq<'Source> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Union(Of TSource) (source1 As IQueryable(Of TSource), source2 As IEnumerable(Of TSource)) As IQueryable(Of TSource)

Paramètres de type

TSource

Type des éléments des séquences d'entrée.The type of the elements of the input sequences.

Paramètres

source1
IQueryable<TSource>

Séquence dont les éléments distincts forment le premier jeu pour l'opération d'union.A sequence whose distinct elements form the first set for the union operation.

source2
IEnumerable<TSource>

Séquence dont les éléments distincts forment le second jeu pour l'opération d'union.A sequence whose distinct elements form the second set for the union operation.

Retours

IQueryable<TSource>

IQueryable<T> qui contient les éléments des deux séquences d'entrée, à l'exception des éléments en double.An IQueryable<T> that contains the elements from both input sequences, excluding duplicates.

Exceptions

source1 ou source2 est null.source1 or source2 is null.

Exemples

L’exemple de code suivant montre comment utiliser Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) pour obtenir l’Union définie de deux séquences.The following code example demonstrates how to use Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) to obtain the set union of two sequences.

int[] ints1 = { 5, 3, 9, 7, 5, 9, 3, 7 };
int[] ints2 = { 8, 3, 6, 4, 4, 9, 1, 0 };

// Get the set union of the items in the two arrays.
IEnumerable<int> union = ints1.AsQueryable().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
*/
Dim ints1() As Integer = {5, 3, 9, 7, 5, 9, 3, 7}
Dim ints2() As Integer = {8, 3, 6, 4, 4, 9, 1, 0}

' Get the set union of the items in the two arrays.
Dim union = ints1.AsQueryable().Union(ints2)

Dim output As New System.Text.StringBuilder
For Each num As Integer In union
    output.Append(String.Format("{0} ", num))
Next

' Display the output.
MsgBox(output.ToString())

' This code produces the following output:

' 5 3 9 7 8 6 4 1 0

Remarques

La Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) méthode génère un MethodCallExpression qui représente l’appel de Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) lui-même comme une méthode générique construite.The Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) method generates a MethodCallExpression that represents calling Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) itself as a constructed generic method. Il passe ensuite MethodCallExpression à la CreateQuery<TElement>(Expression) méthode de IQueryProvider représenté par la Provider propriété du source1 paramètre.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source1 parameter.

Le comportement de la requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) dépend de l’implémentation du type du source1 paramètre.The query behavior that occurs as a result of executing an expression tree that represents calling Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>) depends on the implementation of the type of the source1 parameter. Le comportement attendu est que l’Union définie des éléments dans source1 et source2 est retournée.The expected behavior is that the set union of the elements in source1 and source2 is returned.

S’applique à

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

Produit l'union de deux séquences à l'aide d'un IEqualityComparer<T> spécifié.Produces the set union of two sequences by using a specified IEqualityComparer<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Union(System::Linq::IQueryable<TSource> ^ source1, System::Collections::Generic::IEnumerable<TSource> ^ source2, System::Collections::Generic::IEqualityComparer<TSource> ^ comparer);
public static System.Linq.IQueryable<TSource> Union<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2, System.Collections.Generic.IEqualityComparer<TSource> comparer);
public static System.Linq.IQueryable<TSource> Union<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2, System.Collections.Generic.IEqualityComparer<TSource>? comparer);
static member Union : System.Linq.IQueryable<'Source> * seq<'Source> * System.Collections.Generic.IEqualityComparer<'Source> -> System.Linq.IQueryable<'Source>
<Extension()>
Public Function Union(Of TSource) (source1 As IQueryable(Of TSource), source2 As IEnumerable(Of TSource), comparer As IEqualityComparer(Of TSource)) As IQueryable(Of TSource)

Paramètres de type

TSource

Type des éléments des séquences d'entrée.The type of the elements of the input sequences.

Paramètres

source1
IQueryable<TSource>

Séquence dont les éléments distincts forment le premier jeu pour l'opération d'union.A sequence whose distinct elements form the first set for the union operation.

source2
IEnumerable<TSource>

Séquence dont les éléments distincts forment le second jeu pour l'opération d'union.A sequence whose distinct elements form the second set for the union operation.

comparer
IEqualityComparer<TSource>

IEqualityComparer<T> pour comparer les valeurs.An IEqualityComparer<T> to compare values.

Retours

IQueryable<TSource>

IQueryable<T> qui contient les éléments des deux séquences d'entrée, à l'exception des éléments en double.An IQueryable<T> that contains the elements from both input sequences, excluding duplicates.

Exceptions

source1 ou source2 est null.source1 or source2 is null.

Remarques

La Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) méthode génère un MethodCallExpression qui représente l’appel de Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) lui-même comme une méthode générique construite.The Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) method generates a MethodCallExpression that represents calling Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) itself as a constructed generic method. Il passe ensuite MethodCallExpression à la CreateQuery<TElement>(Expression) méthode de IQueryProvider représenté par la Provider propriété du source1 paramètre.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source1 parameter.

Le comportement de la requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) dépend de l’implémentation du type du source1 paramètre.The query behavior that occurs as a result of executing an expression tree that represents calling Union<TSource>(IQueryable<TSource>, IEnumerable<TSource>, IEqualityComparer<TSource>) depends on the implementation of the type of the source1 parameter. Le comportement attendu est que l’Union définie des éléments dans source1 et source2 est retournée.The expected behavior is that the set union of the elements in source1 and source2 is returned. Le comparer paramètre est utilisé pour comparer des valeurs.The comparer parameter is used to compare values.

S’applique à