Enumerable.SelectMany Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Promítá každý prvek sekvence na a IEnumerable<T> zploštějí výsledné sekvence do jedné sekvence.
Přetížení
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) |
Promítne každý prvek sekvence na IEnumerable<T>, zploštějí výsledné sekvence do jedné sekvence a vyvolá funkci selektoru výsledků pro každý prvek v této sekvenci. |
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) |
Promítne každý prvek sekvence na IEnumerable<T>, zploštějí výsledné sekvence do jedné sekvence a vyvolá funkci selektoru výsledků pro každý prvek v této sekvenci. Index každého zdrojového prvku se používá v přechodné projektované formě tohoto prvku. |
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) |
Promítá každý prvek sekvence na a IEnumerable<T> zploštějí výsledné sekvence do jedné sekvence. |
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) |
Promítá každý prvek sekvence na IEnumerable<T>a zploštěluje výsledné sekvence do jedné sekvence. Index každého zdrojového elementu se používá v projektované formě tohoto elementu. |
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
Promítne každý prvek sekvence na IEnumerable<T>, zploštějí výsledné sekvence do jedné sekvence a vyvolá funkci selektoru výsledků pro každý prvek v této sekvenci.
public:
generic <typename TSource, typename TCollection, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TResult> ^ SelectMany(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Collections::Generic::IEnumerable<TCollection> ^> ^ collectionSelector, Func<TSource, TCollection, TResult> ^ resultSelector);
public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,System.Collections.Generic.IEnumerable<TCollection>> collectionSelector, Func<TSource,TCollection,TResult> resultSelector);
static member SelectMany : seq<'Source> * Func<'Source, seq<'Collection>> * Func<'Source, 'Collection, 'Result> -> seq<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TCollection, TResult) (source As IEnumerable(Of TSource), collectionSelector As Func(Of TSource, IEnumerable(Of TCollection)), resultSelector As Func(Of TSource, TCollection, TResult)) As IEnumerable(Of TResult)
Parametry typu
- TSource
Typ elementů .source
- TCollection
Typ mezilehlých prvků shromážděných nástrojem collectionSelector
.
- TResult
Typ prvků výsledné sekvence.
Parametry
- source
- IEnumerable<TSource>
Posloupnost hodnot, které chcete promítnout.
- collectionSelector
- Func<TSource,IEnumerable<TCollection>>
Transformační funkce, která se použije na každý prvek vstupní sekvence.
- resultSelector
- Func<TSource,TCollection,TResult>
Transformační funkce, která se má použít pro každý prvek mezisekvence.
Návraty
Jejíž IEnumerable<T> elementy jsou výsledkem vyvolání transformační funkce collectionSelector
1:N u každého prvku a následného source
mapování každého z těchto prvků sekvence a jejich odpovídajícího zdrojového prvku na prvek výsledku.
Výjimky
source
resultSelector
nebo collectionSelector
je null
.
Příklady
Následující příklad kódu ukazuje, jak použít SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) k provedení projekce 1:N nad polem a použití funkce selektoru výsledků k zachování každého odpovídajícího prvku ze zdrojové sekvence v rozsahu pro konečné volání .Select
class PetOwner
{
public string Name { get; set; }
public List<string> Pets { get; set; }
}
public static void SelectManyEx3()
{
PetOwner[] petOwners =
{ new PetOwner { Name="Higa",
Pets = new List<string>{ "Scruffy", "Sam" } },
new PetOwner { Name="Ashkenazi",
Pets = new List<string>{ "Walker", "Sugar" } },
new PetOwner { Name="Price",
Pets = new List<string>{ "Scratches", "Diesel" } },
new PetOwner { Name="Hines",
Pets = new List<string>{ "Dusty" } } };
// Project the pet owner's name and the pet's name.
var query =
petOwners
.SelectMany(petOwner => petOwner.Pets, (petOwner, petName) => new { petOwner, petName })
.Where(ownerAndPet => ownerAndPet.petName.StartsWith("S"))
.Select(ownerAndPet =>
new
{
Owner = ownerAndPet.petOwner.Name,
Pet = ownerAndPet.petName
}
);
// Print the results.
foreach (var obj in query)
{
Console.WriteLine(obj);
}
}
// This code produces the following output:
//
// {Owner=Higa, Pet=Scruffy}
// {Owner=Higa, Pet=Sam}
// {Owner=Ashkenazi, Pet=Sugar}
// {Owner=Price, Pet=Scratches}
Structure PetOwner
Public Name As String
Public Pets() As String
End Structure
Sub SelectManyEx3()
' Create an array of PetOwner objects.
Dim petOwners() As PetOwner =
{New PetOwner With
{.Name = "Higa", .Pets = New String() {"Scruffy", "Sam"}},
New PetOwner With
{.Name = "Ashkenazi", .Pets = New String() {"Walker", "Sugar"}},
New PetOwner With
{.Name = "Price", .Pets = New String() {"Scratches", "Diesel"}},
New PetOwner With
{.Name = "Hines", .Pets = New String() {"Dusty"}}}
' Project an anonymous type that consists of
' the owner's name and the pet's name (string).
Dim query =
petOwners _
.SelectMany(
Function(petOwner) petOwner.Pets,
Function(petOwner, petName) New With {petOwner, petName}) _
.Where(Function(ownerAndPet) ownerAndPet.petName.StartsWith("S")) _
.Select(Function(ownerAndPet) _
New With {.Owner = ownerAndPet.petOwner.Name,
.Pet = ownerAndPet.petName
})
Dim output As New System.Text.StringBuilder
For Each obj In query
output.AppendLine(String.Format("Owner={0}, Pet={1}", obj.Owner, obj.Pet))
Next
' Display the output.
Console.WriteLine(output.ToString())
End Sub
' This code produces the following output:
'
' Owner=Higa, Pet=Scruffy
' Owner=Higa, Pet=Sam
' Owner=Ashkenazi, Pet=Sugar
' Owner=Price, Pet=Scratches
Poznámky
Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator
metody přímo, nebo pomocí foreach
v jazyce C# nebo For Each
v jazyce Visual Basic.
Metoda SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) je užitečná, když musíte zachovat prvky v source
oboru pro logiku dotazu, ke které dochází po volání SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Příklad kódu najdete v části Příklad. Pokud existuje obousměrný vztah mezi objekty typu TSource
a objekty typu TCollection
, to znamená, že pokud objekt typu TCollection
poskytuje vlastnost pro načtení objektu TSource
, který ho vytvořil, nepotřebujete toto přetížení SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Místo toho můžete použít SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) objekt a přejít zpět k TSource
objektu prostřednictvím objektu TCollection
.
V syntaxi výrazu dotazu se každá from
klauzule (C#) nebo From
klauzule (Visual Basic) za počátečním výrazem přeloží na vyvolání SelectMany.
Viz také
Platí pro
SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
Promítne každý prvek sekvence na IEnumerable<T>, zploštějí výsledné sekvence do jedné sekvence a vyvolá funkci selektoru výsledků pro každý prvek v této sekvenci. Index každého zdrojového prvku se používá v přechodné projektované formě tohoto prvku.
public:
generic <typename TSource, typename TCollection, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TResult> ^ SelectMany(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, System::Collections::Generic::IEnumerable<TCollection> ^> ^ collectionSelector, Func<TSource, TCollection, TResult> ^ resultSelector);
public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,System.Collections.Generic.IEnumerable<TCollection>> collectionSelector, Func<TSource,TCollection,TResult> resultSelector);
static member SelectMany : seq<'Source> * Func<'Source, int, seq<'Collection>> * Func<'Source, 'Collection, 'Result> -> seq<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TCollection, TResult) (source As IEnumerable(Of TSource), collectionSelector As Func(Of TSource, Integer, IEnumerable(Of TCollection)), resultSelector As Func(Of TSource, TCollection, TResult)) As IEnumerable(Of TResult)
Parametry typu
- TSource
Typ elementů .source
- TCollection
Typ mezilehlých prvků shromážděných nástrojem collectionSelector
.
- TResult
Typ prvků výsledné sekvence.
Parametry
- source
- IEnumerable<TSource>
Posloupnost hodnot, které chcete promítnout.
- collectionSelector
- Func<TSource,Int32,IEnumerable<TCollection>>
Transformační funkce, která se má použít pro každý zdrojový prvek; druhý parametr funkce představuje index elementu source.
- resultSelector
- Func<TSource,TCollection,TResult>
Transformační funkce, která se má použít pro každý prvek mezisekvence.
Návraty
Jejíž IEnumerable<T> elementy jsou výsledkem vyvolání transformační funkce collectionSelector
1:N u každého prvku a následného source
mapování každého z těchto prvků sekvence a jejich odpovídajícího zdrojového prvku na prvek výsledku.
Výjimky
source
resultSelector
nebo collectionSelector
je null
.
Poznámky
Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator
metody přímo, nebo pomocí foreach
v jazyce C# nebo For Each
v jazyce Visual Basic.
Metoda SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) je užitečná, když musíte zachovat prvky v source
oboru pro logiku dotazu, ke které dochází po volání SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Příklad kódu najdete v části Příklad. Pokud existuje obousměrný vztah mezi objekty typu TSource
a objekty typu TCollection
, to znamená, že pokud objekt typu TCollection
poskytuje vlastnost pro načtení objektu TSource
, který ho vytvořil, nepotřebujete toto přetížení SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Místo toho můžete použít SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) objekt a přejít zpět k TSource
objektu prostřednictvím objektu TCollection
.
Platí pro
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
Promítá každý prvek sekvence na a IEnumerable<T> zploštějí výsledné sekvence do jedné sekvence.
public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TResult> ^ SelectMany(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, System::Collections::Generic::IEnumerable<TResult> ^> ^ selector);
public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,System.Collections.Generic.IEnumerable<TResult>> selector);
static member SelectMany : seq<'Source> * Func<'Source, seq<'Result>> -> seq<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TResult) (source As IEnumerable(Of TSource), selector As Func(Of TSource, IEnumerable(Of TResult))) As IEnumerable(Of TResult)
Parametry typu
- TSource
Typ elementů .source
- TResult
Typ prvků sekvence vrácených nástrojem selector
.
Parametry
- source
- IEnumerable<TSource>
Posloupnost hodnot, které chcete promítnout.
- selector
- Func<TSource,IEnumerable<TResult>>
Transformační funkce, která se má použít pro každý prvek.
Návraty
Jejíž IEnumerable<T> prvky jsou výsledkem vyvolání transformační funkce 1:N u každého prvku vstupní sekvence.
Výjimky
source
nebo selector
je null
.
Příklady
Následující příklad kódu ukazuje, jak použít SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) k provedení projekce 1:N přes pole.
class PetOwner
{
public string Name { get; set; }
public List<String> Pets { get; set; }
}
public static void SelectManyEx1()
{
PetOwner[] petOwners =
{ new PetOwner { Name="Higa, Sidney",
Pets = new List<string>{ "Scruffy", "Sam" } },
new PetOwner { Name="Ashkenazi, Ronen",
Pets = new List<string>{ "Walker", "Sugar" } },
new PetOwner { Name="Price, Vernette",
Pets = new List<string>{ "Scratches", "Diesel" } } };
// Query using SelectMany().
IEnumerable<string> query1 = petOwners.SelectMany(petOwner => petOwner.Pets);
Console.WriteLine("Using SelectMany():");
// Only one foreach loop is required to iterate
// through the results since it is a
// one-dimensional collection.
foreach (string pet in query1)
{
Console.WriteLine(pet);
}
// This code shows how to use Select()
// instead of SelectMany().
IEnumerable<List<String>> query2 =
petOwners.Select(petOwner => petOwner.Pets);
Console.WriteLine("\nUsing Select():");
// Notice that two foreach loops are required to
// iterate through the results
// because the query returns a collection of arrays.
foreach (List<String> petList in query2)
{
foreach (string pet in petList)
{
Console.WriteLine(pet);
}
Console.WriteLine();
}
}
/*
This code produces the following output:
Using SelectMany():
Scruffy
Sam
Walker
Sugar
Scratches
Diesel
Using Select():
Scruffy
Sam
Walker
Sugar
Scratches
Diesel
*/
Structure PetOwner
Public Name As String
Public Pets() As String
End Structure
Sub SelectManyEx1()
' Create an array of PetOwner objects.
Dim petOwners() As PetOwner =
{New PetOwner With
{.Name = "Higa, Sidney", .Pets = New String() {"Scruffy", "Sam"}},
New PetOwner With
{.Name = "Ashkenazi, Ronen", .Pets = New String() {"Walker", "Sugar"}},
New PetOwner With
{.Name = "Price, Vernette", .Pets = New String() {"Scratches", "Diesel"}}}
' Call SelectMany() to gather all pets into a "flat" sequence.
Dim query1 As IEnumerable(Of String) =
petOwners.SelectMany(Function(petOwner) petOwner.Pets)
Dim output As New System.Text.StringBuilder("Using SelectMany():" & vbCrLf)
' Only one foreach loop is required to iterate through
' the results because it is a one-dimensional collection.
For Each pet As String In query1
output.AppendLine(pet)
Next
' This code demonstrates how to use Select() instead
' of SelectMany() to get the same result.
Dim query2 As IEnumerable(Of String()) =
petOwners.Select(Function(petOwner) petOwner.Pets)
output.AppendLine(vbCrLf & "Using Select():")
' Notice that two foreach loops are required to iterate through
' the results because the query returns a collection of arrays.
For Each petArray() As String In query2
For Each pet As String In petArray
output.AppendLine(pet)
Next
Next
' Display the output.
Console.WriteLine(output.ToString())
End Sub
' This code produces the following output:
'
' Using SelectMany():
' Scruffy
' Sam
' Walker
' Sugar
' Scratches
' Diesel
'
' Using Select():
' Scruffy
' Sam
' Walker
' Sugar
' Scratches
' Diesel
Poznámky
Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator
metody přímo, nebo pomocí foreach
v jazyce C# nebo For Each
v jazyce Visual Basic.
Metoda SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) vyčíslí vstupní sekvenci, použije transformační funkci k mapování každého prvku na IEnumerable<T>, a pak vytvoří výčet a vynese prvky každého takového IEnumerable<T> objektu. To znamená, že pro každý prvek source
je selector
vyvolána a vrátí se posloupnost hodnot. SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) pak tuto dvourozměrnou kolekci kolekcí zploštědí na jednorozměrnou IEnumerable<T> a vrátí ji. Pokud například dotaz používá SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) k získání objednávek (typu Order
) pro každého zákazníka v databázi, výsledek je typu IEnumerable<Order>
v jazyce C# nebo IEnumerable(Of Order)
v jazyce Visual Basic. Pokud místo toho dotaz použije Select k získání objednávek, kolekce kolekcí objednávek se nezkombinuje a výsledek je typu IEnumerable<List<Order>>
v jazyce C# nebo IEnumerable(Of List(Of Order))
v jazyce Visual Basic.
V syntaxi výrazu dotazu se každá from
klauzule (C#) nebo From
klauzule (Visual Basic) za počátečním výrazem přeloží na vyvolání SelectMany.
Viz také
Platí pro
SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
- Zdroj:
- SelectMany.cs
Promítá každý prvek sekvence na IEnumerable<T>a zploštěluje výsledné sekvence do jedné sekvence. Index každého zdrojového elementu se používá v projektované formě tohoto elementu.
public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<TResult> ^ SelectMany(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, int, System::Collections::Generic::IEnumerable<TResult> ^> ^ selector);
public static System.Collections.Generic.IEnumerable<TResult> SelectMany<TSource,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,int,System.Collections.Generic.IEnumerable<TResult>> selector);
static member SelectMany : seq<'Source> * Func<'Source, int, seq<'Result>> -> seq<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TResult) (source As IEnumerable(Of TSource), selector As Func(Of TSource, Integer, IEnumerable(Of TResult))) As IEnumerable(Of TResult)
Parametry typu
- TSource
Typ elementů .source
- TResult
Typ prvků sekvence vrácených nástrojem selector
.
Parametry
- source
- IEnumerable<TSource>
Posloupnost hodnot, které chcete promítnout.
- selector
- Func<TSource,Int32,IEnumerable<TResult>>
Transformační funkce, která se má použít pro každý zdrojový prvek; druhý parametr funkce představuje index elementu source.
Návraty
Jejíž IEnumerable<T> prvky jsou výsledkem vyvolání transformační funkce 1:N u každého prvku vstupní sekvence.
Výjimky
source
nebo selector
je null
.
Příklady
Následující příklad kódu ukazuje, jak použít SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) k provedení projekce 1:N nad polem a použití indexu každého vnějšího prvku.
class PetOwner
{
public string Name { get; set; }
public List<string> Pets { get; set; }
}
public static void SelectManyEx2()
{
PetOwner[] petOwners =
{ new PetOwner { Name="Higa, Sidney",
Pets = new List<string>{ "Scruffy", "Sam" } },
new PetOwner { Name="Ashkenazi, Ronen",
Pets = new List<string>{ "Walker", "Sugar" } },
new PetOwner { Name="Price, Vernette",
Pets = new List<string>{ "Scratches", "Diesel" } },
new PetOwner { Name="Hines, Patrick",
Pets = new List<string>{ "Dusty" } } };
// Project the items in the array by appending the index
// of each PetOwner to each pet's name in that petOwner's
// array of pets.
IEnumerable<string> query =
petOwners.SelectMany((petOwner, index) =>
petOwner.Pets.Select(pet => index + pet));
foreach (string pet in query)
{
Console.WriteLine(pet);
}
}
// This code produces the following output:
//
// 0Scruffy
// 0Sam
// 1Walker
// 1Sugar
// 2Scratches
// 2Diesel
// 3Dusty
Structure PetOwner
Public Name As String
Public Pets() As String
End Structure
Sub SelectManyEx2()
' Create an array of PetOwner objects.
Dim petOwners() As PetOwner =
{New PetOwner With
{.Name = "Higa, Sidney", .Pets = New String() {"Scruffy", "Sam"}},
New PetOwner With
{.Name = "Ashkenazi, Ronen", .Pets = New String() {"Walker", "Sugar"}},
New PetOwner With
{.Name = "Price, Vernette", .Pets = New String() {"Scratches", "Diesel"}},
New PetOwner With
{.Name = "Hines, Patrick", .Pets = New String() {"Dusty"}}}
' Project the items in the array by appending the index
' of each PetOwner to each pet's name in that petOwner's
' array of pets.
Dim query As IEnumerable(Of String) =
petOwners.SelectMany(Function(petOwner, index) _
petOwner.Pets.Select(Function(pet) _
index.ToString() + pet))
Dim output As New System.Text.StringBuilder
For Each pet As String In query
output.AppendLine(pet)
Next
' Display the output.
Console.WriteLine(output.ToString())
End Sub
Poznámky
Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator
metody přímo, nebo pomocí foreach
v jazyce C# nebo For Each
v jazyce Visual Basic.
Metoda SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) vyčíslí vstupní sekvenci, použije transformační funkci k mapování každého prvku na IEnumerable<T>, a pak vytvoří výčet a vynese prvky každého takového IEnumerable<T> objektu. To znamená, že pro každý prvek source
je selector
vyvolána a vrátí se posloupnost hodnot. SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) pak tuto dvourozměrnou kolekci kolekcí zploštědí na jednorozměrnou IEnumerable<T> a vrátí ji. Pokud například dotaz používá SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) k získání objednávek (typu Order
) pro každého zákazníka v databázi, výsledek je typu IEnumerable<Order>
v jazyce C# nebo IEnumerable(Of Order)
v jazyce Visual Basic. Pokud místo toho dotaz použije Select k získání objednávek, kolekce kolekcí objednávek se nezkombinuje a výsledek je typu IEnumerable<List<Order>>
v jazyce C# nebo IEnumerable(Of List(Of Order))
v jazyce Visual Basic.
První argument selector
představuje prvek, který se má zpracovat. Druhý argument selector
představuje nulový index tohoto prvku ve zdrojové sekvenci. To může být užitečné, pokud jsou prvky ve známém pořadí a chcete něco udělat s elementem v určitém indexu, například. Může být také užitečné, pokud chcete načíst index jednoho nebo více prvků.