Enumerable.Count Enumerable.Count Enumerable.Count Enumerable.Count Method

Definição

Retorna o número de elementos em uma sequência.Returns the number of elements in a sequence.

Sobrecargas

Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>)

Retorna o número de elementos em uma sequência.Returns the number of elements in a sequence.

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

Retorna um número que representa quantos elementos na sequência especificada atendem a uma condição.Returns a number that represents how many elements in the specified sequence satisfy a condition.

Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>) Count<TSource>(IEnumerable<TSource>)

Retorna o número de elementos em uma sequência.Returns the number of elements in a sequence.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static int Count(System::Collections::Generic::IEnumerable<TSource> ^ source);
public static int Count<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);
static member Count : seq<'Source> -> int
<Extension()>
Public Function Count(Of TSource) (source As IEnumerable(Of TSource)) As Integer

Parâmetros de tipo

TSource

O tipo dos elementos de source.The type of the elements of source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência que contém os elementos a serem contados.A sequence that contains elements to be counted.

Retornos

O número de elementos na sequência de entrada.The number of elements in the input sequence.

Exceções

O número de elementos no source é maior que MaxValue.The number of elements in source is larger than MaxValue.

Exemplos

O exemplo de código a seguir demonstra como usar Count<TSource>(IEnumerable<TSource>) para contar os elementos em uma matriz.The following code example demonstrates how to use Count<TSource>(IEnumerable<TSource>) to count the elements in an array.

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.
' Create an array of strings.
Dim fruits() As String = {"apple", "banana", "mango", "orange", "passionfruit", "grape"}

Try
    ' Count the number of items in the array.
    Dim numberOfFruits As Integer = fruits.Count()
    ' Display the output.
    MsgBox("There are " & numberOfFruits & " fruits in the collection.")
Catch e As OverflowException
    MsgBox("The count is too large to store as an Int32. Try using LongCount() instead.")
End Try

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

Comentários

Se o tipo de source implementa ICollection<T>, que a implementação é usada para obter a contagem de elementos.If the type of source implements ICollection<T>, that implementation is used to obtain the count of elements. Caso contrário, este método determina a contagem.Otherwise, this method determines the count.

Use o LongCount método quando você esperar e deseja permitir que o resultado seja maior do que MaxValue.Use the LongCount method when you expect and want to allow the result to be greater than MaxValue.

Na sintaxe de expressão de consulta do Visual Basic, uma Aggregate Into Count() cláusula se traduz em uma invocação de Count.In Visual Basic query expression syntax, an Aggregate Into Count() clause translates to an invocation of Count.

Veja também

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

Retorna um número que representa quantos elementos na sequência especificada atendem a uma condição.Returns a number that represents how many elements in the specified sequence satisfy a condition.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static int Count(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static int Count<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member Count : seq<'Source> * Func<'Source, bool> -> int
<Extension()>
Public Function Count(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As Integer

Parâmetros de tipo

TSource

O tipo dos elementos de source.The type of the elements of source.

Parâmetros

source
IEnumerable<TSource>

Uma sequência que contém os elementos a serem testados e contados.A sequence that contains elements to be tested and counted.

predicate
Func<TSource,Boolean>

Uma função para testar cada elemento em relação a uma condição.A function to test each element for a condition.

Retornos

Um número que representa quantos elementos na sequência atendem à condição na função de predicado.A number that represents how many elements in the sequence satisfy the condition in the predicate function.

Exceções

source ou predicate é null.source or predicate is null.

O número de elementos no source é maior que MaxValue.The number of elements in source is larger than 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 satisfazem uma condição.The following code example demonstrates how to use Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to count the elements in an array that satisfy a condition.

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.
Structure Pet
    Public Name As String
    Public Vaccinated As Boolean
End Structure

Public Shared Sub CountEx2()
    ' Create an array of Pet objects.
    Dim pets() As Pet = {New Pet With {.Name = "Barley", .Vaccinated = True},
                 New Pet With {.Name = "Boots", .Vaccinated = False},
                 New Pet With {.Name = "Whiskers", .Vaccinated = False}}

    Try
        ' Count the number of Pets in the array where the Vaccinated property is False.
        Dim numberUnvaccinated As Integer =
    pets.Count(Function(p) p.Vaccinated = False)
        ' Display the output.
        MsgBox("There are " & numberUnvaccinated & " unvaccinated animals.")
    Catch e As OverflowException
        MsgBox("The count is too large to store as an Int32. Try using LongCount() instead.")
    End Try

End Sub

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

Comentários

Se o tipo de source implementa ICollection<T>, que a implementação é usada para obter a contagem de elementos.If the type of source implements ICollection<T>, that implementation is used to obtain the count of elements. Caso contrário, este método determina a contagem.Otherwise, this method determines the count.

Você deve usar o LongCount método quando você esperar e deseja permitir que o resultado seja maior do que MaxValue.You should use the LongCount method when you expect and want to allow the result to be greater than MaxValue.

Na sintaxe de expressão de consulta do Visual Basic, uma Aggregate Into Count() cláusula se traduz em uma invocação de Count.In Visual Basic query expression syntax, an Aggregate Into Count() clause translates to an invocation of Count.

Veja também

Aplica-se a