Informações
O tópico solicitado está sendo mostrado abaixo. No entanto, este tópico não está incluído nesta biblioteca.

Método Enumerable.Take<TSource>

Retorna um número especificado de elementos contíguas desde o início de uma sequência.

Namespace:  System.Linq
Assembly:  System.Core (em System.Core.dll)

public static IEnumerable<TSource> Take<TSource>(
	this IEnumerable<TSource> source,
	int count
)

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
A sequência para retornar os elementos do.
count
Tipo: System.Int32
O número de elementos a ser retornado.

Valor de retorno

Tipo: System.Collections.Generic.IEnumerable<TSource>
IEnumerable<T> que contém o número especificado de elementos desde o início da sequência de entrada.

Observação de uso

No Visual Basic e no C#, você pode chamar esse método como um método de instância em qualquer objeto do tipo IEnumerable<TSource>. Quando você usar a sintaxe de método de instância para chamar esse método, omita o primeiro parâmetro. Para obter mais informações, consulte Métodos de extensão (Visual Basic) ou Métodos de extensão (Guia de Programação em C#).

ExceçãoCondição
ArgumentNullException

source é null.

Esse método é implementado usando a execução diferida. O valor de retorno imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando o método de GetEnumerator diretamente ou usando foreach em Visual C# ou For Each em Visual Basic.

Take<TSource> enumera source e gerencie o os elementos até que os elementos de count sejam rendidos ou source não conterá nenhum outro elemento. Se count excede o número de elementos em source, todos os elementos de source são retornados.

Se count é menor ou igual a zero, source não é enumerado e IEnumerable<T> vazio será retornado.

Os métodos de Take<TSource> e de Skip<TSource> são complementos funcionais. Dada uma sequência coll e um inteiro n, concatenar os resultados de coll.Take(n) e de coll.Skip(n) gerencie a mesma sequência que coll.

Na sintaxe da expressão de consulta de Visual Basic , uma cláusula de Take converte a uma invocação de Take<TSource>.

O exemplo de código a seguir demonstra como usar Take<TSource> para retornar os elementos desde o início de uma sequência.


            int[] grades = { 59, 82, 70, 56, 92, 98, 85 };

            IEnumerable<int> topThreeGrades =
                grades.OrderByDescending(grade => grade).Take(3);

            Console.WriteLine("The top three grades are:");
            foreach (int grade in topThreeGrades)
            {
                Console.WriteLine(grade);
            }
            /*
             This code produces the following output:

             The top three grades are:
             98
             92
             85
            */



.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

Mostrar:
© 2014 Microsoft