Enumerable.Count Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Retorna o número de elementos em uma sequência.

Sobrecargas

Count<TSource>(IEnumerable<TSource>)	Retorna o número de elementos em uma sequência.
Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Retorna um número que representa quantos elementos na sequência especificada atendem a uma condição.

Count<TSource>(IEnumerable<TSource>)

Origem:

Count.cs

Retorna o número de elementos em uma sequência.

C#

public static int Count<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Uma sequência que contém os elementos a serem contados.

Retornos

Int32

O número de elementos na sequência de entrada.

Exceções

ArgumentNullException

source é null.

OverflowException

O número de elementos em source é maior que Int32.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Count<TSource>(IEnumerable<TSource>) para contar os elementos em uma matriz.

C#

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

try
{
    int numberOfFruits = fruits.Count();
    Console.WriteLine(
        "There are {0} fruits in the collection.",
        numberOfFruits);
}
catch (OverflowException)
{
    Console.WriteLine("The count is too large to store as an Int32.");
    Console.WriteLine("Try using the LongCount() method instead.");
}

// This code produces the following output:
//
// There are 6 fruits in the collection.

Comentários

Se o tipo de source implementa ICollection<T>, essa implementação será usada para obter a contagem de elementos. Caso contrário, esse método determina a contagem.

Use o LongCount método quando você espera e deseja permitir que o resultado seja maior que MaxValue.

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Count() cláusula é convertida em uma invocação de Count.

Confira também

• Cláusula Aggregate (Visual Basic)

Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Origem:

Count.cs

Retorna um número que representa quantos elementos na sequência especificada atendem a uma condição.

C#

public static int Count<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Uma sequência que contém os elementos a serem testados e contados.

predicate

Func<TSource,Boolean>

Uma função para testar cada elemento em relação a uma condição.

Retornos

Int32

Um número que representa quantos elementos na sequência atendem à condição na função de predicado.

Exceções

ArgumentNullException

source ou predicate é null.

OverflowException

O número de elementos em source é maior que Int32.MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) para contar os elementos em uma matriz que atenda a uma condição.

C#

class Pet
{
    public string Name { get; set; }
    public bool Vaccinated { get; set; }
}

public static void CountEx2()
{
    Pet[] pets = { new Pet { Name="Barley", Vaccinated=true },
                   new Pet { Name="Boots", Vaccinated=false },
                   new Pet { Name="Whiskers", Vaccinated=false } };

    try
    {
        int numberUnvaccinated = pets.Count(p => p.Vaccinated == false);
        Console.WriteLine("There are {0} unvaccinated animals.", numberUnvaccinated);
    }
    catch (OverflowException)
    {
        Console.WriteLine("The count is too large to store as an Int32.");
        Console.WriteLine("Try using the LongCount() method instead.");
    }
}

// This code produces the following output:
//
// There are 2 unvaccinated animals.

Comentários

Se o tipo de source implementa ICollection<T>, essa implementação será usada para obter a contagem de elementos. Caso contrário, esse método determina a contagem.

Você deve usar o LongCount método quando espera e deseja permitir que o resultado seja maior que MaxValue.

Na sintaxe da expressão de consulta do Visual Basic, uma Aggregate Into Count() cláusula é convertida em uma invocação de Count.

Confira também

• Cláusula Aggregate (Visual Basic)