Queryable.GroupJoin Metoda

Definice

Obor názvů:

System.Linq

Sestavení:

System.Linq.Queryable.dll

Koreluje prvky dvou sekvencí na základě rovnosti klíčů a seskupuje výsledky.

Přetížení

GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>)	Koreluje prvky dvou sekvencí na základě rovnosti klíčů a seskupuje výsledky. K porovnání klíčů se používá výchozí porovnávače rovnosti.
GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>)	Koreluje prvky dvou sekvencí na základě rovnosti klíčů a seskupuje výsledky. Zadaná IEqualityComparer<T> hodnota se používá k porovnání klíčů.

GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>)

Zdroj:

Queryable.cs

Koreluje prvky dvou sekvencí na základě rovnosti klíčů a seskupuje výsledky. K porovnání klíčů se používá výchozí porovnávače rovnosti.

public static System.Linq.IQueryable<TResult> GroupJoin<TOuter,TInner,TKey,TResult> (this System.Linq.IQueryable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, System.Linq.Expressions.Expression<Func<TOuter,TKey>> outerKeySelector, System.Linq.Expressions.Expression<Func<TInner,TKey>> innerKeySelector, System.Linq.Expressions.Expression<Func<TOuter,System.Collections.Generic.IEnumerable<TInner>,TResult>> resultSelector);

Parametry typu

TOuter

Typ prvků první sekvence.

TInner

Typ prvků druhé sekvence.

TKey

Typ klíčů vrácených funkcemi selektoru klíčů

TResult

Typ prvků výsledku.

Parametry

outer

IQueryable<TOuter>

První sekvence, která se má spojit.

inner

IEnumerable<TInner>

Sekvence, která se má spojit s první sekvencí.

outerKeySelector

Expression<Func<TOuter,TKey>>

Funkce, která extrahuje klíč spojení z každého prvku první sekvence.

innerKeySelector

Expression<Func<TInner,TKey>>

Funkce, která extrahuje klíč spojení z každého prvku druhé sekvence.

resultSelector

Expression<Func<TOuter,IEnumerable<TInner>,TResult>>

Funkce pro vytvoření prvku výsledku z elementu z první sekvence a kolekce odpovídajících prvků z druhé sekvence.

Návraty

IQueryable<TResult>

Obsahuje IQueryable<T> prvky typu TResult získané provedením seskupené spojení ve dvou sekvencích.

Výjimky

ArgumentNullException

outer nebo inner nebo outerKeySelectorinnerKeySelector nebo je resultSelectornull.

Příklady

Následující příklad kódu ukazuje, jak použít GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) k provedení seskupené spojení ve dvou sekvencích.

class Person
{
    public string Name { get; set; }
}

class Pet
{
    public string Name { get; set; }
    public Person Owner { get; set; }
}

public static void GroupJoinEx1()
{
    Person magnus = new Person { Name = "Hedlund, Magnus" };
    Person terry = new Person { Name = "Adams, Terry" };
    Person charlotte = new Person { Name = "Weiss, Charlotte" };

    Pet barley = new Pet { Name = "Barley", Owner = terry };
    Pet boots = new Pet { Name = "Boots", Owner = terry };
    Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte };
    Pet daisy = new Pet { Name = "Daisy", Owner = magnus };

    List<Person> people = new List<Person> { magnus, terry, charlotte };
    List<Pet> pets = new List<Pet> { barley, boots, whiskers, daisy };

    // Create a list where each element is an anonymous
    // type that contains a person's name and a collection
    // of names of the pets that are owned by them.
    var query =
        people.AsQueryable().GroupJoin(pets,
                         person => person,
                         pet => pet.Owner,
                         (person, petCollection) =>
                             new
                             {
                                 OwnerName = person.Name,
                                 Pets = petCollection.Select(pet => pet.Name)
                             });

    foreach (var obj in query)
    {
        // Output the owner's name.
        Console.WriteLine("{0}:", obj.OwnerName);
        // Output each of the owner's pet's names.
        foreach (string pet in obj.Pets)
            Console.WriteLine("  {0}", pet);
    }
}

/*
    This code produces the following output:

    Hedlund, Magnus:
      Daisy
    Adams, Terry:
      Barley
      Boots
    Weiss, Charlotte:
      Whiskers
*/

Poznámky

Tato metoda má alespoň jeden parametr typu Expression<TDelegate> , jehož argument typu je jedním z Func<T,TResult> typů. Pro tyto parametry můžete předat výraz lambda, který se zkompiluje do Expression<TDelegate>.

Metoda GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) vygeneruje metodu MethodCallExpression , která představuje volání GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) sebe sama jako konstruovanou obecnou metodu. Pak předá MethodCallExpression metodu IQueryProviderCreateQuery<TElement>(Expression) reprezentované Provider vlastností parametru outer .

Chování dotazu, ke kterému dochází v důsledku spuštění stromu výrazů, který představuje volání GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>) , závisí na implementaci typu parametru outer . Očekávané chování je, že outerKeySelector funkce a innerKeySelector se používají k extrakci klíčů z outer a inner. Tyto klíče se porovnávají, aby se rovnost shodovaly s nulou outer nebo více elementy z inner. resultSelector Potom je vyvolána funkce pro promítání objektu výsledku z každé skupiny korelačních prvků.

GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>)

Zdroj:

Queryable.cs

Koreluje prvky dvou sekvencí na základě rovnosti klíčů a seskupuje výsledky. Zadaná IEqualityComparer<T> hodnota se používá k porovnání klíčů.

public static System.Linq.IQueryable<TResult> GroupJoin<TOuter,TInner,TKey,TResult> (this System.Linq.IQueryable<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, System.Linq.Expressions.Expression<Func<TOuter,TKey>> outerKeySelector, System.Linq.Expressions.Expression<Func<TInner,TKey>> innerKeySelector, System.Linq.Expressions.Expression<Func<TOuter,System.Collections.Generic.IEnumerable<TInner>,TResult>> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parametry typu

TOuter

Typ prvků první sekvence.

TInner

Typ prvků druhé sekvence.

TKey

Typ klíčů vrácených funkcemi selektoru klíčů

TResult

Typ prvků výsledku.

Parametry

outer

IQueryable<TOuter>

První sekvence, která se má spojit.

inner

IEnumerable<TInner>

Sekvence, která se má spojit s první sekvencí.

outerKeySelector

Expression<Func<TOuter,TKey>>

Funkce, která extrahuje klíč spojení z každého prvku první sekvence.

innerKeySelector

Expression<Func<TInner,TKey>>

Funkce, která extrahuje klíč spojení z každého prvku druhé sekvence.

resultSelector

Expression<Func<TOuter,IEnumerable<TInner>,TResult>>

Funkce pro vytvoření prvku výsledku z elementu z první sekvence a kolekce odpovídajících prvků z druhé sekvence.

comparer

IEqualityComparer<TKey>

Porovnávače hodnot hash a porovnávacího klíče.

Návraty

IQueryable<TResult>

Obsahuje IQueryable<T> prvky typu TResult získané provedením seskupené spojení ve dvou sekvencích.

Výjimky

ArgumentNullException

outer nebo inner nebo outerKeySelectorinnerKeySelector nebo je resultSelectornull.

Poznámky

Tato metoda má alespoň jeden parametr typu Expression<TDelegate> , jehož argument typu je jedním z Func<T,TResult> typů. Pro tyto parametry můžete předat výraz lambda, který se zkompiluje do Expression<TDelegate>.

Metoda GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) vygeneruje metodu MethodCallExpression , která představuje volání GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) sebe sama jako konstruovanou obecnou metodu. Pak předá MethodCallExpression metodu IQueryProviderCreateQuery<TElement>(Expression) reprezentované Provider vlastností parametru outer .

Chování dotazu, ke kterému dochází v důsledku spuštění stromu výrazů, který představuje volání GroupJoin<TOuter,TInner,TKey,TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter,TKey>>, Expression<Func<TInner,TKey>>, Expression<Func<TOuter,IEnumerable<TInner>,TResult>>, IEqualityComparer<TKey>) , závisí na implementaci typu parametru outer . Očekávané chování je, že outerKeySelector funkce a innerKeySelector se používají k extrakci klíčů z outer a inner. Tyto klíče se porovnávají z hlediska rovnosti pomocí .comparer Výsledek porovnání se používá ke spárování každého prvku v outer s nulou nebo více elementy z inner. resultSelector Potom je vyvolána funkce pro promítání objektu výsledku z každé skupiny korelačních prvků.