Queryable.SelectMany Metoda

Definicja

Projektuje każdy element sekwencji do IEnumerable<T> i łączy wyniki sekwencji w jedną sekwencję typu IQueryable<T> .Projects each element of a sequence to an IEnumerable<T> and combines the resulting sequences into one sequence of type IQueryable<T>.

Przeciążenia

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

Projektuje każdy element sekwencji do IEnumerable<T> , który zawiera indeks elementu źródłowego, który go utworzył.Projects each element of a sequence to an IEnumerable<T> that incorporates the index of the source element that produced it. Funkcja selektora wyników jest wywoływana dla każdego elementu każdej pośredniej sekwencji, a wynikowe wartości są łączone w jedną sekwencję jednowymiarową i zwracają.A result selector function is invoked on each element of each intermediate sequence, and the resulting values are combined into a single, one-dimensional sequence and returned.

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

Projektuje każdy element sekwencji do IEnumerable<T> i wywołuje funkcję selektora wyników dla każdego elementu w nim.Projects each element of a sequence to an IEnumerable<T> and invokes a result selector function on each element therein. Wynikowe wartości z każdej sekwencji pośredniej są łączone w jedną sekwencję jednowymiarową i zwracają.The resulting values from each intermediate sequence are combined into a single, one-dimensional sequence and returned.

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

Projektuje każdy element sekwencji do IEnumerable<T> i łączy wyniki sekwencji w jedną sekwencję.Projects each element of a sequence to an IEnumerable<T> and combines the resulting sequences into one sequence. Indeks każdego elementu źródłowego jest używany w przewidywanej formie tego elementu.The index of each source element is used in the projected form of that element.

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

Projektuje każdy element sekwencji do IEnumerable<T> i łączy wyniki sekwencji w jedną sekwencję.Projects each element of a sequence to an IEnumerable<T> and combines the resulting sequences into one sequence.

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

Projektuje każdy element sekwencji do IEnumerable<T> , który zawiera indeks elementu źródłowego, który go utworzył.Projects each element of a sequence to an IEnumerable<T> that incorporates the index of the source element that produced it. Funkcja selektora wyników jest wywoływana dla każdego elementu każdej pośredniej sekwencji, a wynikowe wartości są łączone w jedną sekwencję jednowymiarową i zwracają.A result selector function is invoked on each element of each intermediate sequence, and the resulting values are combined into a single, one-dimensional sequence and returned.

public:
generic <typename TSource, typename TCollection, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ SelectMany(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, int, System::Collections::Generic::IEnumerable<TCollection> ^> ^> ^ collectionSelector, System::Linq::Expressions::Expression<Func<TSource, TCollection, TResult> ^> ^ resultSelector);
public static System.Linq.IQueryable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int,System.Collections.Generic.IEnumerable<TCollection>>> collectionSelector, System.Linq.Expressions.Expression<Func<TSource,TCollection,TResult>> resultSelector);
static member SelectMany : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, int, seq<'Collection>>> * System.Linq.Expressions.Expression<Func<'Source, 'Collection, 'Result>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TCollection, TResult) (source As IQueryable(Of TSource), collectionSelector As Expression(Of Func(Of TSource, Integer, IEnumerable(Of TCollection))), resultSelector As Expression(Of Func(Of TSource, TCollection, TResult))) As IQueryable(Of TResult)

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

TCollection

Typ elementów pośrednich zebranych przez funkcję reprezentowane przez collectionSelector .The type of the intermediate elements collected by the function represented by collectionSelector.

TResult

Typ elementów wyniku sekwencji.The type of the elements of the resulting sequence.

Parametry

source
IQueryable<TSource>

Sekwencja wartości do projektu.A sequence of values to project.

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

Funkcja projekcji do zastosowania do każdego elementu sekwencji wejściowej; drugi parametr tej funkcji reprezentuje indeks elementu źródłowego.A projection function to apply to each element of the input sequence; the second parameter of this function represents the index of the source element.

resultSelector
Expression<Func<TSource,TCollection,TResult>>

Funkcja projekcji do zastosowania do każdego elementu każdej pośredniej sekwencji.A projection function to apply to each element of each intermediate sequence.

Zwraca

IQueryable<TResult>

IQueryable<T>Których elementy są wynikiem wywołania funkcji projekcji "jeden do wielu" collectionSelector dla każdego elementu source , a następnie mapowania poszczególnych elementów sekwencji i odpowiadających im elementów source do elementu wynik.An IQueryable<T> whose elements are the result of invoking the one-to-many projection function collectionSelector on each element of source and then mapping each of those sequence elements and their corresponding source element to a result element.

Wyjątki

source or collectionSelector lub resultSelector is null .source or collectionSelector or resultSelector is null.

Uwagi

Ta metoda ma co najmniej jeden parametr typu Expression<TDelegate> , którego argument typu jest jednym z Func<T,TResult> typów.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Dla tych parametrów można przekazać wyrażenie lambda i zostanie ono skompilowane do Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>)Metoda generuje element MethodCallExpression reprezentujący wywoływanie SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) jako metodę rodzajową.The SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) method generates a MethodCallExpression that represents calling SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) itself as a constructed generic method. Następnie przekazuje MethodCallExpression do CreateQuery(Expression) metody IQueryProvider reprezentowanej przez Provider Właściwość source parametru.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażenia, które reprezentuje wywołanie, SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) zależy od implementacji typu source parametru.The query behavior that occurs as a result of executing an expression tree that represents calling SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) depends on the implementation of the type of the source parameter. Oczekiwane zachowanie jest wywoływane collectionSelector dla każdego elementu w source celu zaprojektowania go w postaci wyliczalnej.The expected behavior is that it invokes collectionSelector on each element of source to project it into an enumerable form. Każdy wyliczalny wynik obejmuje indeks elementu źródłowego.Each enumerable result incorporates the source element's index. Następnie funkcja reprezentowana przez resultSelector jest wywoływana dla każdego elementu w każdej pośredniej sekwencji.Then the function represented by resultSelector is invoked on each element in each intermediate sequence. Wyniki są łączone w jedną sekwencję jednowymiarową.The resulting values are concatenated into a single, one-dimensional sequence.

Dotyczy

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

Projektuje każdy element sekwencji do IEnumerable<T> i wywołuje funkcję selektora wyników dla każdego elementu w nim.Projects each element of a sequence to an IEnumerable<T> and invokes a result selector function on each element therein. Wynikowe wartości z każdej sekwencji pośredniej są łączone w jedną sekwencję jednowymiarową i zwracają.The resulting values from each intermediate sequence are combined into a single, one-dimensional sequence and returned.

public:
generic <typename TSource, typename TCollection, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ SelectMany(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, System::Collections::Generic::IEnumerable<TCollection> ^> ^> ^ collectionSelector, System::Linq::Expressions::Expression<Func<TSource, TCollection, TResult> ^> ^ resultSelector);
public static System.Linq.IQueryable<TResult> SelectMany<TSource,TCollection,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,System.Collections.Generic.IEnumerable<TCollection>>> collectionSelector, System.Linq.Expressions.Expression<Func<TSource,TCollection,TResult>> resultSelector);
static member SelectMany : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, seq<'Collection>>> * System.Linq.Expressions.Expression<Func<'Source, 'Collection, 'Result>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TCollection, TResult) (source As IQueryable(Of TSource), collectionSelector As Expression(Of Func(Of TSource, IEnumerable(Of TCollection))), resultSelector As Expression(Of Func(Of TSource, TCollection, TResult))) As IQueryable(Of TResult)

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

TCollection

Typ elementów pośrednich zebranych przez funkcję reprezentowane przez collectionSelector .The type of the intermediate elements collected by the function represented by collectionSelector.

TResult

Typ elementów wyniku sekwencji.The type of the elements of the resulting sequence.

Parametry

source
IQueryable<TSource>

Sekwencja wartości do projektu.A sequence of values to project.

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

Funkcja projekcji do zastosowania do każdego elementu sekwencji wejściowej.A projection function to apply to each element of the input sequence.

resultSelector
Expression<Func<TSource,TCollection,TResult>>

Funkcja projekcji do zastosowania do każdego elementu każdej pośredniej sekwencji.A projection function to apply to each element of each intermediate sequence.

Zwraca

IQueryable<TResult>

IQueryable<T>Których elementy są wynikiem wywołania funkcji projekcji "jeden do wielu" collectionSelector dla każdego elementu source , a następnie mapowania poszczególnych elementów sekwencji i odpowiadających im elementów source do elementu wynik.An IQueryable<T> whose elements are the result of invoking the one-to-many projection function collectionSelector on each element of source and then mapping each of those sequence elements and their corresponding source element to a result element.

Wyjątki

source or collectionSelector lub resultSelector is null .source or collectionSelector or resultSelector is null.

Przykłady

Poniższy przykład kodu demonstruje, jak używać SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) do wykonywania projekcji "jeden do wielu" na tablicy.The following code example demonstrates how to use SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) to perform a one-to-many projection over an array. W tym przykładzie zastosowano funkcję selektora wyniku, aby zachować element źródłowy, który odpowiada każdej pośredniej sekwencji w zakresie dla końcowego wywołania do Select .This example uses a result selector function to keep the source element that corresponds to each intermediate sequence in scope for the final call to Select.

class PetOwner
{
    public string Name { get; set; }
    public List<Pet> Pets { get; set; }
}

class Pet
{
    public string Name { get; set; }
    public string Breed { get; set; }
}

public static void SelectManyEx3()
{
    PetOwner[] petOwners =
        { new PetOwner { Name="Higa",
              Pets = new List<Pet>{
                  new Pet { Name="Scruffy", Breed="Poodle" },
                  new Pet { Name="Sam", Breed="Hound" } } },
          new PetOwner { Name="Ashkenazi",
              Pets = new List<Pet>{
                  new Pet { Name="Walker", Breed="Collie" },
                  new Pet { Name="Sugar", Breed="Poodle" } } },
          new PetOwner { Name="Price",
              Pets = new List<Pet>{
                  new Pet { Name="Scratches", Breed="Dachshund" },
                  new Pet { Name="Diesel", Breed="Collie" } } },
          new PetOwner { Name="Hines",
              Pets = new List<Pet>{
                  new Pet { Name="Dusty", Breed="Collie" } } }
        };

    // This query demonstrates how to obtain a sequence of
    // the names of all the pets whose breed is "Collie", while
    // keeping an association with the owner that owns the pet.
    var query =
        petOwners.AsQueryable()
        // Create a sequence of ALL the Pet objects. Then
        // project an anonymous type that consists of each
        // Pet in the new sequence and the PetOwner object
        // from the initial array that corresponds to that pet.
       .SelectMany(owner => owner.Pets,
                   (owner, pet) => new { owner, pet })
        // Filter the sequence of anonymous types to only
        // keep pets whose breed is "Collie".
        .Where(ownerAndPet => ownerAndPet.pet.Breed == "Collie")
        // Project an anonymous type that consists
        // of the pet owner's name and the pet's name.
        .Select(ownerAndPet => new
        {
            Owner = ownerAndPet.owner.Name,
            Pet = ownerAndPet.pet.Name
        });

    // Print the results.
    foreach (var obj in query)
        Console.WriteLine(obj);
}

/* This code produces the following output:

    { Owner = Ashkenazi, Pet = Walker }
    { Owner = Price, Pet = Diesel }
    { Owner = Hines, Pet = Dusty }
*/

Structure PetOwner
    Public Name As String
    Public Pets As List(Of Pet)
End Structure

Structure Pet
    Public Name As String
    Public Breed As String
End Structure

Shared Sub SelectManyEx3()
    Dim petOwners() As PetOwner = _
                {New PetOwner With {.Name = "Higa", _
                      .Pets = New List(Of Pet)(New Pet() { _
                          New Pet With {.Name = "Scruffy", .Breed = "Poodle"}, _
                          New Pet With {.Name = "Sam", .Breed = "Hound"}})}, _
                  New PetOwner With {.Name = "Ashkenazi", _
                      .Pets = New List(Of Pet)(New Pet() { _
                          New Pet With {.Name = "Walker", .Breed = "Collie"}, _
                          New Pet With {.Name = "Sugar", .Breed = "Poodle"}})}, _
                  New PetOwner With {.Name = "Price", _
                      .Pets = New List(Of Pet)(New Pet() { _
                          New Pet With {.Name = "Scratches", .Breed = "Dachshund"}, _
                          New Pet With {.Name = "Diesel", .Breed = "Collie"}})}, _
                  New PetOwner With {.Name = "Hines", _
                      .Pets = New List(Of Pet)(New Pet() { _
                          New Pet With {.Name = "Dusty", .Breed = "Collie"}})} _
                }

    ' This query demonstrates how to obtain a sequence of
    ' the names of all the pets whose breed is "Collie", while
    ' keeping an association with the owner that owns the pet.
    Dim query = petOwners.AsQueryable() _
        .SelectMany(Function(owner) owner.Pets, _
               Function(owner, pet) New With {owner, pet}) _
        .Where(Function(ownerAndPet) ownerAndPet.pet.Breed = "Collie") _
        .Select(Function(ownerAndPet) New With { _
            .Owner = ownerAndPet.owner.Name, _
            .Pet = ownerAndPet.pet.Name})

    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.
    MsgBox(output.ToString())
End Sub

' This code produces the following output:

' Owner=Ashkenazi, Pet=Walker
' Owner=Price, Pet=Diesel
' Owner=Hines, Pet=Dusty

Uwagi

Ta metoda ma co najmniej jeden parametr typu Expression<TDelegate> , którego argument typu jest jednym z Func<T,TResult> typów.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Dla tych parametrów można przekazać wyrażenie lambda i zostanie ono skompilowane do Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>)Metoda generuje element MethodCallExpression reprezentujący wywoływanie SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) jako metodę rodzajową.The SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) method generates a MethodCallExpression that represents calling SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) itself as a constructed generic method. Następnie przekazuje MethodCallExpression do CreateQuery(Expression) metody IQueryProvider reprezentowanej przez Provider Właściwość source parametru.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażenia, które reprezentuje wywołanie, SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) zależy od implementacji typu source parametru.The query behavior that occurs as a result of executing an expression tree that represents calling SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection,TResult>>) depends on the implementation of the type of the source parameter. Oczekiwane zachowanie jest wywoływane collectionSelector dla każdego elementu w source celu zaprojektowania go w postaci wyliczalnej.The expected behavior is that it invokes collectionSelector on each element of source to project it into an enumerable form. Następnie funkcja reprezentowana przez resultSelector jest wywoływana dla każdego elementu w każdej pośredniej sekwencji.Then the function represented by resultSelector is invoked on each element in each intermediate sequence. Wyniki są łączone w jedną sekwencję jednowymiarową.The resulting values are concatenated into a single, one-dimensional sequence.

Dotyczy

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

Projektuje każdy element sekwencji do IEnumerable<T> i łączy wyniki sekwencji w jedną sekwencję.Projects each element of a sequence to an IEnumerable<T> and combines the resulting sequences into one sequence. Indeks każdego elementu źródłowego jest używany w przewidywanej formie tego elementu.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::Linq::IQueryable<TResult> ^ SelectMany(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, int, System::Collections::Generic::IEnumerable<TResult> ^> ^> ^ selector);
public static System.Linq.IQueryable<TResult> SelectMany<TSource,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,int,System.Collections.Generic.IEnumerable<TResult>>> selector);
static member SelectMany : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, int, seq<'Result>>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TResult) (source As IQueryable(Of TSource), selector As Expression(Of Func(Of TSource, Integer, IEnumerable(Of TResult)))) As IQueryable(Of TResult)

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

TResult

Typ elementów sekwencji zwracanych przez funkcję reprezentowane przez selector .The type of the elements of the sequence returned by the function represented by selector.

Parametry

source
IQueryable<TSource>

Sekwencja wartości do projektu.A sequence of values to project.

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

Funkcja projekcji do zastosowania do każdego elementu; drugi parametr tej funkcji reprezentuje indeks elementu źródłowego.A projection function to apply to each element; the second parameter of this function represents the index of the source element.

Zwraca

IQueryable<TResult>

IQueryable<T>Którego elementy są wynikiem wywołania funkcji projekcji jeden do wielu na każdym elemencie sekwencji wejściowej.An IQueryable<T> whose elements are the result of invoking a one-to-many projection function on each element of the input sequence.

Wyjątki

source lub selector jest null .source or selector is null.

Przykłady

Poniższy przykład kodu demonstruje, jak używać SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) do wykonywania projekcji jeden do wielu na tablicy i używania indeksu każdego elementu źródłowego.The following code example demonstrates how to use SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) to perform a one-to-many projection over an array and use the index of each source 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" } } };

    // For each PetOwner element in the source array,
    // project a sequence of strings where each string
    // consists of the index of the PetOwner element in the
    // source array and the name of each pet in PetOwner.Pets.
    IEnumerable<string> query =
        petOwners.AsQueryable()
        .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

Shared Sub SelectManyEx2()
    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"}}}

    ' For each PetOwner element in the source array,
    ' project a sequence of strings where each string
    ' consists of the index of the PetOwner element in the
    ' source array and the name of each pet in PetOwner.Pets.
    Dim query As IEnumerable(Of String) = _
        petOwners.AsQueryable() _
        .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.
    MsgBox(output.ToString())
End Sub

' This code produces the following output:
'
' 0Scruffy
' 0Sam
' 1Walker
' 1Sugar
' 2Scratches
' 2Diesel
' 3Dusty

Uwagi

Ta metoda ma co najmniej jeden parametr typu Expression<TDelegate> , którego argument typu jest jednym z Func<T,TResult> typów.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Dla tych parametrów można przekazać wyrażenie lambda i zostanie ono skompilowane do Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>)Metoda generuje element MethodCallExpression reprezentujący wywoływanie SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) jako metodę rodzajową.The SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) method generates a MethodCallExpression that represents calling SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) itself as a constructed generic method. Następnie przekazuje MethodCallExpression do CreateQuery(Expression) metody IQueryProvider reprezentowanej przez Provider Właściwość source parametru.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażenia, które reprezentuje wywołanie, SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) zależy od implementacji typu source parametru.The query behavior that occurs as a result of executing an expression tree that represents calling SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) depends on the implementation of the type of the source parameter. Oczekiwane zachowanie jest wywoływane selector dla każdego elementu w source celu zaprojektowania go w postaci wyliczalnej.The expected behavior is that it invokes selector on each element of source to project it into an enumerable form. Każdy wyliczalny wynik obejmuje indeks elementu źródłowego.Each enumerable result incorporates the index of the source element. Następnie łączy wyliczalne wyniki w jedną jednowymiarową sekwencję.It then concatenates the enumerable results into a single, one-dimensional sequence.

Dotyczy

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

Projektuje każdy element sekwencji do IEnumerable<T> i łączy wyniki sekwencji w jedną sekwencję.Projects each element of a sequence to an IEnumerable<T> and combines the resulting sequences into one sequence.

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ SelectMany(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, System::Collections::Generic::IEnumerable<TResult> ^> ^> ^ selector);
public static System.Linq.IQueryable<TResult> SelectMany<TSource,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,System.Collections.Generic.IEnumerable<TResult>>> selector);
static member SelectMany : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, seq<'Result>>> -> System.Linq.IQueryable<'Result>
<Extension()>
Public Function SelectMany(Of TSource, TResult) (source As IQueryable(Of TSource), selector As Expression(Of Func(Of TSource, IEnumerable(Of TResult)))) As IQueryable(Of TResult)

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

TResult

Typ elementów sekwencji zwracanych przez funkcję reprezentowane przez selector .The type of the elements of the sequence returned by the function represented by selector.

Parametry

source
IQueryable<TSource>

Sekwencja wartości do projektu.A sequence of values to project.

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

Funkcja projekcji do zastosowania do każdego elementu.A projection function to apply to each element.

Zwraca

IQueryable<TResult>

IQueryable<T>Którego elementy są wynikiem wywołania funkcji projekcji jeden do wielu na każdym elemencie sekwencji wejściowej.An IQueryable<T> whose elements are the result of invoking a one-to-many projection function on each element of the input sequence.

Wyjątki

source lub selector jest null .source or selector is null.

Przykłady

Poniższy przykład kodu demonstruje, jak używać SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) do wykonywania projekcji "jeden do wielu" na tablicy.The following code example demonstrates how to use SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<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.AsQueryable().SelectMany(petOwner => petOwner.Pets);

    Console.WriteLine("Using SelectMany():");

    // Only one foreach loop is required to iterate through the
    // results because 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.AsQueryable().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

Shared Sub SelectManyEx1()
    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"}}}

    ' Query using SelectMany().
    Dim query1 As IEnumerable(Of String) = _
                petOwners.AsQueryable().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 shows how to use Select() instead of SelectMany().
    Dim query2 As IEnumerable(Of String()) = _
                petOwners.AsQueryable().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.
    MsgBox(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

Uwagi

Ta metoda ma co najmniej jeden parametr typu Expression<TDelegate> , którego argument typu jest jednym z Func<T,TResult> typów.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Dla tych parametrów można przekazać wyrażenie lambda i zostanie ono skompilowane do Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>)Metoda generuje element MethodCallExpression reprezentujący wywoływanie SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) jako metodę rodzajową.The SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) method generates a MethodCallExpression that represents calling SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) itself as a constructed generic method. Następnie przekazuje MethodCallExpression do CreateQuery(Expression) metody IQueryProvider reprezentowanej przez Provider Właściwość source parametru.It then passes the MethodCallExpression to the CreateQuery(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażenia, które reprezentuje wywołanie, SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) zależy od implementacji typu source parametru.The query behavior that occurs as a result of executing an expression tree that represents calling SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) depends on the implementation of the type of the source parameter. Oczekiwane zachowanie jest wywoływane selector dla każdego elementu w source celu zaprojektowania go w postaci wyliczalnej.The expected behavior is that it invokes selector on each element of source to project it into an enumerable form. Następnie łączy wyliczalne wyniki w jedną jednowymiarową sekwencję.It then concatenates the enumerable results into a single, one-dimensional sequence.

Dotyczy