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

Definición

Crea un List<T> a partir de un IEnumerable<T>.Creates a List<T> from an 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.The type of the elements of source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> a partir del cual se va a crear List<T>.The IEnumerable<T> to create a List<T> from.

Devoluciones

List<TSource>

List<T> que contiene los elementos de la secuencia de entrada.A List<T> that contains elements from the input sequence.

Excepciones

source es null.source is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar ToList para forzar la evaluación inmediata de la consulta y devolver un valor de List<T> que contiene los resultados de la consulta.The following code example demonstrates how to use ToList to force immediate query evaluation and return a List<T> that contains the query results.

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> que contiene los resultados de la consulta.The ToList<TSource>(IEnumerable<TSource>) method forces immediate query evaluation and returns a List<T> that contains the query results. Puede anexar este método a la consulta para obtener una copia en caché de los resultados de la consulta.You can append this method to your query in order to obtain a cached copy of the query results.

ToArray tiene un comportamiento similar, pero devuelve una matriz en lugar de una List<T> .ToArray has similar behavior but returns an array instead of a List<T>.

Se aplica a