Enumerable.ToList<TSource>(IEnumerable<TSource>) Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Source:

ToCollection.cs

Crea un List<T> a partir de un IEnumerable<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::List<TSource> ^ ToList(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static System.Collections.Generic.List<TSource> ToList<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

static member ToList : seq<'Source> -> System.Collections.Generic.List<'Source>

<Extension()>
Public Function ToList(Of TSource) (source As IEnumerable(Of TSource)) As List(Of TSource)

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear List<T>.

Devoluciones

List<TSource>

List<T> que contiene los elementos de la secuencia de entrada.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ToList para forzar la evaluación inmediata de consultas y devolver un List<T> objeto que contiene los resultados de la consulta.

string[] fruits = { "apple", "passionfruit", "banana", "mango",
                      "orange", "blueberry", "grape", "strawberry" };

List<int> lengths = fruits.Select(fruit => fruit.Length).ToList();

foreach (int length in lengths)
{
    Console.WriteLine(length);
}

/*
 This code produces the following output:

 5
 12
 6
 5
 6
 9
 5
 10
*/

' Create an array of strings.
Dim fruits() As String =
{"apple", "passionfruit", "banana", "mango",
 "orange", "blueberry", "grape", "strawberry"}

' Project the length of each string and
' put the length values into a List object.
Dim lengths As List(Of Integer) =
fruits _
.Select(Function(fruit) fruit.Length) _
.ToList()

' Display the results.
Dim output As New System.Text.StringBuilder
For Each length As Integer In lengths
    output.AppendLine(length)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' 5
' 12
' 6
' 5
' 6
' 9
' 5
' 10

Comentarios

El ToList<TSource>(IEnumerable<TSource>) método fuerza la evaluación inmediata de la consulta y devuelve un List<T> objeto que contiene los resultados de la consulta. Puede anexar este método a la consulta para obtener una copia almacenada en caché de los resultados de la consulta.

ToArraytiene un comportamiento similar, pero devuelve una matriz en lugar de .List<T>