Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Enumerable.SelectMany<TSource, TResult>(IEnumerable<TSource>, Func<TSource, IEnumerable<TResult>>)

 

Publicado: noviembre de 2016

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

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static IEnumerable<TResult> SelectMany<TSource, TResult>(
	this IEnumerable<TSource> source,
	Func<TSource, IEnumerable<TResult>> selector
)

Parámetros

source
Type: System.Collections.Generic.IEnumerable<TSource>

Secuencia de valores que se va a proyectar.

selector
Type: System.Func<TSource, IEnumerable<TResult>>

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

Valor devuelto

Type: System.Collections.Generic.IEnumerable<TResult>

Una IEnumerable<T> cuyos elementos son el resultado de invocar la función de transformación uno a varios en cada elemento de la secuencia de entrada.

Parámetros de tipo

TSource

Tipo de los elementos de source.

TResult

El tipo de los elementos de la secuencia devueltos por selector.

Exception Condition
ArgumentNullException

El valor de source o selector es null.

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto llamando a su GetEnumerator método directamente o mediante foreach en Visual C# o For Each en Visual Basic.

El SelectMany<TSource, TResult>(IEnumerable<TSource>, Func<TSource, IEnumerable<TResult>>) método enumera la secuencia de entrada, utiliza una función de transformación para asignar cada elemento de un IEnumerable<T>, y, a continuación, enumera y genera los elementos de cada estos IEnumerable<T> objeto. Es decir, para cada elemento de source, selector se invoca y se devuelve una secuencia de valores. SelectMany<TSource, TResult>(IEnumerable<TSource>, Func<TSource, IEnumerable<TResult>>) a continuación, convierte esta colección de colecciones en unidimensional bidimensional IEnumerable<T> y lo devuelve. Por ejemplo, si una consulta utiliza SelectMany<TSource, TResult>(IEnumerable<TSource>, Func<TSource, IEnumerable<TResult>>) para obtener los pedidos (de tipo Order) para cada cliente en una base de datos, el resultado es de tipo IEnumerable<Order> en C# o IEnumerable(Of Order) en Visual Basic. Si la consulta utiliza Select<TSource, TResult> para obtener los pedidos, la colección de colecciones de pedidos no se combina y el resultado es de tipo IEnumerable<List<Order>> en C# o IEnumerable(Of List(Of Order)) en Visual Basic.

En la sintaxis de expresión de consulta, cada from cláusula (Visual C#) o From cláusula (Visual Basic) después de la inicial uno se convierte en una invocación de SelectMany<TSource, TResult>.

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

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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: