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, Int32, IEnumerable<TResult>>)

 

Publicado: octubre de 2016

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

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, int, 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, Int32, IEnumerable<TResult>>

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

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 una 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, Int32, 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, Int32, 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, Int32, 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.

El primer argumento para selector representa el elemento que se va a procesar. El segundo argumento selector representa el índice de base cero del elemento en la secuencia de origen. Esto puede ser útil si los elementos están en un orden conocido y desea hacer algo con un elemento en un índice determinado, por ejemplo. También puede ser útil si desea recuperar el índice de uno o más elementos.

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

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

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: