Ler em inglês

Partilhar via


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

Definição

Cria uma matriz de um IEnumerable<T>.

public static TSource[] ToArray<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
IEnumerable<TSource>

Um IEnumerable<T> para criar uma matriz.

Retornos

TSource[]

Uma matriz que contém os elementos da sequência de entrada.

Exceções

source é null.

Exemplos

O exemplo de código a seguir demonstra como usar ToArray para forçar a avaliação imediata da consulta e retornar uma matriz de resultados.

class Package
{
    public string Company { get; set; }
    public double Weight { get; set; }
}

public static void ToArrayEx1()
{
    List<Package> packages =
        new List<Package>
            { new Package { Company = "Coho Vineyard", Weight = 25.2 },
              new Package { Company = "Lucerne Publishing", Weight = 18.7 },
              new Package { Company = "Wingtip Toys", Weight = 6.0 },
              new Package { Company = "Adventure Works", Weight = 33.8 } };

    string[] companies = packages.Select(pkg => pkg.Company).ToArray();

    foreach (string company in companies)
    {
        Console.WriteLine(company);
    }
}

/*
 This code produces the following output:

 Coho Vineyard
 Lucerne Publishing
 Wingtip Toys
 Adventure Works
*/

Comentários

O ToArray<TSource>(IEnumerable<TSource>) método força a avaliação imediata da consulta e retorna uma matriz que contém os resultados da consulta. Você pode acrescentar esse método à consulta para obter uma cópia armazenada em cache dos resultados da consulta.

ToList tem um comportamento semelhante, mas retorna um List<T> em vez de uma matriz.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0