Queryable.SelectMany Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.Queryable.dll

Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> y combina las secuencias resultantes en una secuencia de tipo IQueryable<T>.

Sobrecargas

SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>)	Proyecta cada elemento de una secuencia en IEnumerable<T> e invoca una función del selector de resultados en cada elemento. Los valores resultantes de cada secuencia intermedia se combinan en una única secuencia unidimensional y se devuelven.
SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>)	Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> que incorpora el índice del elemento de origen que lo generó. Una función del selector de resultados se invoca en cada elemento de todas las secuencias intermedias y luego los valores resultantes se combinan en una única secuencia unidimensional y se devuelven.
SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>)	Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> y combina las secuencias resultantes en una secuencia.
SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>)	Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> y combina las secuencias resultantes en una secuencia. El índice de cada elemento de origen se utiliza en el formulario proyectado de ese elemento.

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

Source:

Queryable.cs

Proyecta cada elemento de una secuencia en IEnumerable<T> e invoca una función del selector de resultados en cada elemento. Los valores resultantes de cada secuencia intermedia se combinan en una única secuencia unidimensional y se devuelven.

C#

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TCollection

El tipo de los elementos intermedios recopilados por la función representada por collectionSelector.

TResult

Tipo de los elementos de la secuencia resultante.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a proyectar.

collectionSelector

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

Función de proyección que se va a aplicar a cada elemento de la secuencia de entrada.

resultSelector

Expression<Func<TSource,TCollection,TResult>>

Función de proyección que se va a aplicar a cada elemento de la secuencia intermedia.

Devoluciones

IQueryable<TResult>

IQueryable<T> cuyos elementos son el resultado de invocar la función de proyección uno a varios collectionSelector en cada elemento de source y de asignar a continuación cada uno de los elementos de la secuencia y sus elementos de source correspondientes a un elemento de resultado.

Excepciones

ArgumentNullException

source o collectionSelector o resultSelector es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) para realizar una proyección uno a varios en una matriz. En este ejemplo se usa una función del selector de resultados para mantener el elemento de origen que corresponde a cada secuencia intermedia en el ámbito de la llamada final a Select.

C#

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 }
*/

Comentarios

Este método tiene al menos un parámetro de tipo cuyo argumento de tipo Expression<TDelegate> es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) método genera un MethodCallExpression objeto que representa llamarse SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que invoca collectionSelector en cada elemento de source para proyectarlo en un formulario enumerable. A continuación, se invoca la función representada por resultSelector en cada elemento de cada secuencia intermedia. Los valores resultantes se concatenan en una sola secuencia unidimensional.

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

Source:

Queryable.cs

Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> que incorpora el índice del elemento de origen que lo generó. Una función del selector de resultados se invoca en cada elemento de todas las secuencias intermedias y luego los valores resultantes se combinan en una única secuencia unidimensional y se devuelven.

C#

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TCollection

El tipo de los elementos intermedios recopilados por la función representada por collectionSelector.

TResult

Tipo de los elementos de la secuencia resultante.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a proyectar.

collectionSelector

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

Función de proyección que se va a aplicar a cada elemento de la secuencia de entrada; el segundo parámetro de esta función representa el índice del elemento de origen.

resultSelector

Expression<Func<TSource,TCollection,TResult>>

Función de proyección que se va a aplicar a cada elemento de la secuencia intermedia.

Devoluciones

IQueryable<TResult>

IQueryable<T> cuyos elementos son el resultado de invocar la función de proyección uno a varios collectionSelector en cada elemento de source y de asignar a continuación cada uno de los elementos de la secuencia y sus elementos de source correspondientes a un elemento de resultado.

Excepciones

ArgumentNullException

source o collectionSelector o resultSelector es null.

Comentarios

Este método tiene al menos un parámetro de tipo cuyo argumento de tipo Expression<TDelegate> es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) método genera un MethodCallExpression objeto que representa llamarse SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada SelectMany<TSource,TCollection,TResult>(IQueryable<TSource>, Expression<Func<TSource, Int32,IEnumerable<TCollection>>>, Expression<Func<TSource,TCollection, TResult>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que invoca collectionSelector en cada elemento de source para proyectarlo en un formulario enumerable. Cada resultado enumerable incorpora el índice del elemento de origen. A continuación, se invoca la función representada por resultSelector en cada elemento de cada secuencia intermedia. Los valores resultantes se concatenan en una sola secuencia unidimensional.

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

Source:

Queryable.cs

Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> y combina las secuencias resultantes en una secuencia.

C#

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TResult

Tipo de los elementos de la secuencia devuelta por la función representada por selector.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a proyectar.

selector

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

Función de proyección que se va a aplicar a cada elemento.

Devoluciones

IQueryable<TResult>

IQueryable<T> cuyos elementos son el resultado de invocar una función de proyección uno a varios en cada elemento de la secuencia de entrada.

Excepciones

ArgumentNullException

source o selector es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) para realizar una proyección uno a varios en una matriz.

C#

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
*/

Comentarios

Este método tiene al menos un parámetro de tipo cuyo argumento de tipo Expression<TDelegate> es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) método genera un MethodCallExpression objeto que representa llamarse SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,IEnumerable<TResult>>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que invoca selector en cada elemento de source para proyectarlo en un formulario enumerable. A continuación, concatena los resultados enumerables en una sola secuencia unidimensional.

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

Source:

Queryable.cs

Proyecta cada elemento de una secuencia en una interfaz IEnumerable<T> y combina las secuencias resultantes en una secuencia. El índice de cada elemento de origen se utiliza en el formulario proyectado de ese elemento.

C#

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);

Parámetros de tipo

TSource

Tipo de los elementos de source.

TResult

Tipo de los elementos de la secuencia devuelta por la función representada por selector.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a proyectar.

selector

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

Función de proyección que se va a aplicar a cada elemento; el segundo parámetro de esta función representa el índice del elemento de origen.

Devoluciones

IQueryable<TResult>

IQueryable<T> cuyos elementos son el resultado de invocar una función de proyección uno a varios en cada elemento de la secuencia de entrada.

Excepciones

ArgumentNullException

source o selector es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) para realizar una proyección uno a varios en una matriz y usar el índice de cada elemento de origen.

C#

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

Comentarios

Este método tiene al menos un parámetro de tipo cuyo argumento de tipo Expression<TDelegate> es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) método genera un MethodCallExpression objeto que representa llamarse SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada SelectMany<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,Int32,IEnumerable<TResult>>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que invoca selector en cada elemento de source para proyectarlo en un formulario enumerable. Cada resultado enumerable incorpora el índice del elemento de origen. A continuación, concatena los resultados enumerables en una sola secuencia unidimensional.