Enumerable.SelectMany Metoda

Definice

Projekty jednotlivé prvky sekvence do IEnumerable<T> a sloučí výsledné sekvence do jedné sekvence.Projects each element of a sequence to an IEnumerable<T> and flattens the resulting sequences into one sequence.

Přetížení

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

Projekty jednotlivé prvky sekvence na IEnumerable<T> , sloučí výsledné sekvence do jedné sekvence a vyvolá funkci selektor výsledku pro každý prvek v rámci.Projects each element of a sequence to an IEnumerable<T>, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein.

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

Projekty jednotlivé prvky sekvence na IEnumerable<T> , sloučí výsledné sekvence do jedné sekvence a vyvolá funkci selektor výsledku pro každý prvek v rámci.Projects each element of a sequence to an IEnumerable<T>, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein. Index jednotlivých zdrojových elementů se používá v mezilehlém projektovém formuláři tohoto prvku.The index of each source element is used in the intermediate projected form of that element.

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)

Projekty jednotlivé prvky sekvence do IEnumerable<T> a sloučí výsledné sekvence do jedné sekvence.Projects each element of a sequence to an IEnumerable<T> and flattens the resulting sequences into one sequence.

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)

Projekty jsou jednotlivé prvky sekvence IEnumerable<T> a jsou shrnuty ve výsledných sekvencích do jedné sekvence.Projects each element of a sequence to an IEnumerable<T>, and flattens the resulting sequences into one sequence. Index každého zdrojového elementu se používá v projektované podobě daného prvku.The index of each source element is used in the projected form of that element.

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

Projekty jednotlivé prvky sekvence na IEnumerable<T> , sloučí výsledné sekvence do jedné sekvence a vyvolá funkci selektor výsledku pro každý prvek v rámci.Projects each element of a sequence to an IEnumerable<T>, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein.

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 prvků source .The type of the elements of source.

TCollection

Typ zprostředkujících prvků shromažďovaných collectionSelector .The type of the intermediate elements collected by collectionSelector.

TResult

Typ prvků výsledné sekvence.The type of the elements of the resulting sequence.

Parametry

source
IEnumerable<TSource>

Sekvence hodnot do projektu.A sequence of values to project.

collectionSelector
Func<TSource,IEnumerable<TCollection>>

Funkce transformace, která má být použita na každý prvek vstupní sekvence.A transform function to apply to each element of the input sequence.

resultSelector
Func<TSource,TCollection,TResult>

Transformační funkce, která má být použita na každý prvek mezilehlé sekvence.A transform function to apply to each element of the intermediate sequence.

Návraty

IEnumerable<TResult>

IEnumerable<T>Jejichž prvky jsou výsledkem vyvolání funkce transformace 1: n collectionSelector u každého prvku source a poté mapování každého z těchto elementů sekvence a jejich odpovídajícího zdrojového elementu na výsledný element.An IEnumerable<T> whose elements are the result of invoking the one-to-many transform function collectionSelector on each element of source and then mapping each of those sequence elements and their corresponding source element to a result element.

Výjimky

source nebo collectionSelector resultSelector je null .source or collectionSelector or resultSelector is 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:1 nad polem a použití funkce selektor výsledku k uchování každého odpovídajícího prvku ze zdrojové sekvence v rozsahu pro konečné volání Select .The following code example demonstrates how to use SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) to perform a one-to-many projection over an array and use a result selector function to keep each corresponding element from the source sequence in scope for the final call to 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 je implementována pomocí odloženého provedení.This method is implemented by using deferred execution. Okamžitá návratová hodnota je objekt, který ukládá všechny informace, které jsou požadovány k provedení této akce.The immediate return value is an object that stores all the information that is required to perform the action. Dotaz reprezentovaný touto metodou není proveden, dokud se nevytvoří výčet objektu buď voláním GetEnumerator metody přímo nebo pomocí foreach jazyka Visual C# nebo For Each Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)Metoda je užitečná v případě, že je nutné zachovat prvky source v rozsahu pro logiku dotazu, která nastane po volání metody SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) .The SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) method is useful when you have to keep the elements of source in scope for query logic that occurs after the call to SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Příklad kódu naleznete v části příklad.See the Example section for a code example. Pokud existuje obousměrný vztah mezi objekty typu TSource a objekty typu TCollection , tj. Pokud objekt typu TCollection poskytuje vlastnost pro načtení TSource objektu, který jej vytvořil, nepotřebujete toto přetížení SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) .If there is a bidirectional relationship between objects of type TSource and objects of type TCollection, that is, if an object of type TCollection provides a property to retrieve the TSource object that produced it, you do not need this overload of 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>>) a přejít zpět k TSource objektu prostřednictvím TCollection objektu.Instead, you can use SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) and navigate back to the TSource object through the TCollection object.

V syntaxi výrazu dotazu každá from klauzule (Visual C#) nebo From klauzule (Visual Basic) po počátečním převodu na vyvolání SelectMany .In query expression syntax, each from clause (Visual C#) or From clause (Visual Basic) after the initial one translates to an invocation of SelectMany.

Viz také

Platí pro

Produkt Představení

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)

Projekty jednotlivé prvky sekvence na IEnumerable<T> , sloučí výsledné sekvence do jedné sekvence a vyvolá funkci selektor výsledku pro každý prvek v rámci.Projects each element of a sequence to an IEnumerable<T>, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein. Index jednotlivých zdrojových elementů se používá v mezilehlém projektovém formuláři tohoto prvku.The index of each source element is used in the intermediate projected form of that element.

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 prvků source .The type of the elements of source.

TCollection

Typ zprostředkujících prvků shromažďovaných collectionSelector .The type of the intermediate elements collected by collectionSelector.

TResult

Typ prvků výsledné sekvence.The type of the elements of the resulting sequence.

Parametry

source
IEnumerable<TSource>

Sekvence hodnot do projektu.A sequence of values to project.

collectionSelector
Func<TSource,Int32,IEnumerable<TCollection>>

Funkce transformace, která se má použít u každého zdrojového elementu; druhý parametr funkce představuje index zdrojového elementu.A transform function to apply to each source element; the second parameter of the function represents the index of the source element.

resultSelector
Func<TSource,TCollection,TResult>

Transformační funkce, která má být použita na každý prvek mezilehlé sekvence.A transform function to apply to each element of the intermediate sequence.

Návraty

IEnumerable<TResult>

IEnumerable<T>Jejichž prvky jsou výsledkem vyvolání funkce transformace 1: n collectionSelector u každého prvku source a poté mapování každého z těchto elementů sekvence a jejich odpovídajícího zdrojového elementu na výsledný element.An IEnumerable<T> whose elements are the result of invoking the one-to-many transform function collectionSelector on each element of source and then mapping each of those sequence elements and their corresponding source element to a result element.

Výjimky

source nebo collectionSelector resultSelector je null .source or collectionSelector or resultSelector is null.

Poznámky

Tato metoda je implementována pomocí odloženého provedení.This method is implemented by using deferred execution. Okamžitá návratová hodnota je objekt, který ukládá všechny informace, které jsou požadovány k provedení této akce.The immediate return value is an object that stores all the information that is required to perform the action. Dotaz reprezentovaný touto metodou není proveden, dokud se nevytvoří výčet objektu buď voláním GetEnumerator metody přímo nebo pomocí foreach jazyka Visual C# nebo For Each Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>)Metoda je užitečná v případě, že je nutné zachovat prvky source v rozsahu pro logiku dotazu, která nastane po volání metody SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) .The SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) method is useful when you have to keep the elements of source in scope for query logic that occurs after the call to SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>). Příklad kódu naleznete v části příklad.See the Example section for a code example. Pokud existuje obousměrný vztah mezi objekty typu TSource a objekty typu TCollection , tj. Pokud objekt typu TCollection poskytuje vlastnost pro načtení TSource objektu, který jej vytvořil, nepotřebujete toto přetížení SelectMany<TSource,TCollection,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TCollection>>, Func<TSource,TCollection,TResult>) .If there is a bidirectional relationship between objects of type TSource and objects of type TCollection, that is, if an object of type TCollection provides a property to retrieve the TSource object that produced it, you do not need this overload of 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>>) a přejít zpět k TSource objektu prostřednictvím TCollection objektu.Instead, you can use SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) and navigate back to the TSource object through the TCollection object.

Platí pro

Produkt Představení

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)

Projekty jednotlivé prvky sekvence do IEnumerable<T> a sloučí výsledné sekvence do jedné sekvence.Projects each element of a sequence to an IEnumerable<T> and flattens the resulting sequences into one sequence.

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 prvků source .The type of the elements of source.

TResult

Typ prvků sekvence, kterou vrátí selector .The type of the elements of the sequence returned by selector.

Parametry

source
IEnumerable<TSource>

Sekvence hodnot do projektu.A sequence of values to project.

selector
Func<TSource,IEnumerable<TResult>>

Transformační funkce, která má být použita pro každý prvek.A transform function to apply to each element.

Návraty

IEnumerable<TResult>

IEnumerable<T>Jejichž prvky jsou výsledkem vyvolání funkce transformace 1: n u každého prvku vstupní sekvence.An IEnumerable<T> whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.

Výjimky

source nebo selector je null .source or selector is 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 nad polem.The following code example demonstrates how to use SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) to perform a one-to-many projection over an array.

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 je implementována pomocí odloženého provedení.This method is implemented by using deferred execution. Okamžitá návratová hodnota je objekt, který ukládá všechny informace, které jsou požadovány k provedení této akce.The immediate return value is an object that stores all the information that is required to perform the action. Dotaz reprezentovaný touto metodou není proveden, dokud se nevytvoří výčet objektu buď voláním GetEnumerator metody přímo nebo pomocí foreach jazyka Visual C# nebo For Each Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>)Metoda vytvoří výčet vstupní sekvence, používá transformaci funkce k namapování jednotlivých prvků na a IEnumerable<T> poté vytvoří výčet a vypočítá prvky každého takového IEnumerable<T> objektu.The SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) method enumerates the input sequence, uses a transform function to map each element to an IEnumerable<T>, and then enumerates and yields the elements of each such IEnumerable<T> object. To znamená, že pro každý element source selector je vyvolána a bude vrácena sekvence hodnot.That is, for each element of source, selector is invoked and a sequence of values is returned. SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) pak sloučí tyto dvourozměrné kolekce kolekcí do jednorozměrného IEnumerable<T> a vrátí.SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) then flattens this two-dimensional collection of collections into a one-dimensional IEnumerable<T> and returns it. Například pokud 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 Visual Basic.For example, if a query uses SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,IEnumerable<TResult>>) to obtain the orders (of type Order) for each customer in a database, the result is of type IEnumerable<Order> in C# or IEnumerable(Of Order) in Visual Basic. Pokud místo toho dotaz použije Select k získání objednávek, kolekce kolekcí objednávek není kombinována a výsledek je typu IEnumerable<List<Order>> v jazyce C# nebo IEnumerable(Of List(Of Order)) v Visual Basic.If instead the query uses Select to obtain the orders, the collection of collections of orders is not combined and the result is of type IEnumerable<List<Order>> in C# or IEnumerable(Of List(Of Order)) in Visual Basic.

V syntaxi výrazu dotazu každá from klauzule (Visual C#) nebo From klauzule (Visual Basic) po počátečním převodu na vyvolání SelectMany .In query expression syntax, each from clause (Visual C#) or From clause (Visual Basic) after the initial one translates to an invocation of SelectMany.

Viz také

Platí pro

Produkt Představení

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)

Projekty jsou jednotlivé prvky sekvence IEnumerable<T> a jsou shrnuty ve výsledných sekvencích do jedné sekvence.Projects each element of a sequence to an IEnumerable<T>, and flattens the resulting sequences into one sequence. Index každého zdrojového elementu se používá v projektované podobě daného prvku.The index of each source element is used in the projected form of that element.

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 prvků source .The type of the elements of source.

TResult

Typ prvků sekvence, kterou vrátí selector .The type of the elements of the sequence returned by selector.

Parametry

source
IEnumerable<TSource>

Sekvence hodnot do projektu.A sequence of values to project.

selector
Func<TSource,Int32,IEnumerable<TResult>>

Funkce transformace, která se má použít u každého zdrojového elementu; druhý parametr funkce představuje index zdrojového elementu.A transform function to apply to each source element; the second parameter of the function represents the index of the source element.

Návraty

IEnumerable<TResult>

IEnumerable<T>Jejichž prvky jsou výsledkem vyvolání funkce transformace 1: n u každého prvku vstupní sekvence.An IEnumerable<T> whose elements are the result of invoking the one-to-many transform function on each element of an input sequence.

Výjimky

source nebo selector je null .source or selector is 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.The following code example demonstrates how to use SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) to perform a one-to-many projection over an array and use the index of each outer element.

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 je implementována pomocí odloženého provedení.This method is implemented by using deferred execution. Okamžitá návratová hodnota je objekt, který ukládá všechny informace, které jsou požadovány k provedení této akce.The immediate return value is an object that stores all the information that is required to perform the action. Dotaz reprezentovaný touto metodou není proveden, dokud se nevytvoří výčet objektu buď voláním GetEnumerator metody přímo nebo pomocí foreach jazyka Visual C# nebo For Each Visual Basic.The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>)Metoda vytvoří výčet vstupní sekvence, používá transformaci funkce k namapování jednotlivých prvků na a IEnumerable<T> poté vytvoří výčet a vypočítá prvky každého takového IEnumerable<T> objektu.The SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) method enumerates the input sequence, uses a transform function to map each element to an IEnumerable<T>, and then enumerates and yields the elements of each such IEnumerable<T> object. To znamená, že pro každý element source selector je vyvolána a bude vrácena sekvence hodnot.That is, for each element of source, selector is invoked and a sequence of values is returned. SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) pak sloučí tyto dvourozměrné kolekce kolekcí do jednorozměrného IEnumerable<T> a vrátí.SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) then flattens this two-dimensional collection of collections into a one-dimensional IEnumerable<T> and returns it. Například pokud 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 Visual Basic.For example, if a query uses SelectMany<TSource,TResult>(IEnumerable<TSource>, Func<TSource,Int32,IEnumerable<TResult>>) to obtain the orders (of type Order) for each customer in a database, the result is of type IEnumerable<Order> in C# or IEnumerable(Of Order) in Visual Basic. Pokud místo toho dotaz použije Select k získání objednávek, kolekce kolekcí objednávek není kombinována a výsledek je typu IEnumerable<List<Order>> v jazyce C# nebo IEnumerable(Of List(Of Order)) v Visual Basic.If instead the query uses Select to obtain the orders, the collection of collections of orders is not combined and the result is of type IEnumerable<List<Order>> in C# or IEnumerable(Of List(Of Order)) in Visual Basic.

První argument selector představující prvek, který má být zpracován.The first argument to selector represents the element to process. Druhý argument selector představuje index založený na nule tohoto prvku ve zdrojové sekvenci.The second argument to selector represents the zero-based index of that element in the source sequence. To může být užitečné, pokud jsou prvky ve známém pořadí a chcete něco dělat s elementem na konkrétním indexu, například.This can be useful if the elements are in a known order and you want to do something with an element at a particular index, for example. Může být také užitečné, pokud chcete načíst index jednoho nebo více prvků.It can also be useful if you want to retrieve the index of one or more elements.

Platí pro

Produkt Představení