Enumerable.Count Méthode

Définition

Espace de noms:
System.Linq
Assemblys:
System.Core.dll, System.Linq.dll
Assembly:
System.Core.dll
Assembly:
System.Linq.dll
Assembly:
netstandard.dll

Retourne le nombre d’éléments d’une séquence.

Surcharges

Nom Description
Count<TSource>(IEnumerable<TSource>)

Retourne le nombre d’éléments d’une séquence.
Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Retourne un nombre qui représente le nombre d’éléments de la séquence spécifiée qui répondent à une condition.

Count<TSource>(IEnumerable<TSource>)

Retourne le nombre d’éléments d’une séquence.

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

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IEnumerable<TSource>

Séquence qui contient des éléments à compter.

Retours

Int32

Nombre d’éléments dans la séquence d’entrée.

Exceptions

ArgumentNullException

source a la valeur null.

OverflowException

Le nombre d’éléments inclus source est supérieur à Int32.MaxValue.

Exemples

L’exemple de code suivant montre comment compter Count<TSource>(IEnumerable<TSource>) les éléments d’un tableau.

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.
    Console.WriteLine($"There are {numberOfFruits} fruits in the collection.")
Catch e As OverflowException
    Console.WriteLine("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.

Remarques

Si le type d’implémentations sourceICollection<T>est utilisé pour obtenir le nombre d’éléments. Sinon, cette méthode détermine le nombre.

Utilisez la LongCount méthode lorsque vous attendez et souhaitez autoriser le résultat à être supérieur MaxValueà .

Dans Visual Basic syntaxe d’expression de requête, une clause Aggregate Into Count() se traduit par un appel de Count.

Voir aussi

S’applique à

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

Retourne un nombre qui représente le nombre d’éléments de la séquence spécifiée qui répondent à une 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

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IEnumerable<TSource>

Séquence qui contient des éléments à tester et à compter.

predicate
Func<TSource,Boolean>

Fonction permettant de tester chaque élément pour une condition.

Retours

Int32

Nombre qui représente le nombre d’éléments de la séquence qui répondent à la condition dans la fonction de prédicat.

Exceptions

ArgumentNullException

source ou predicate est null.

OverflowException

Le nombre d’éléments inclus source est supérieur à Int32.MaxValue.

Exemples

L’exemple de code suivant montre comment utiliser Count<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) pour compter les éléments d’un tableau qui répondent à une 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);
        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.
        Console.WriteLine($"There are {numberUnvaccinated} unvaccinated animals.")
    Catch e As OverflowException
        Console.WriteLine("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.

Remarques

Si le type d’implémentations sourceICollection<T>est utilisé pour obtenir le nombre d’éléments. Sinon, cette méthode détermine le nombre.

Vous devez utiliser la LongCount méthode lorsque vous vous attendez et que vous souhaitez autoriser le résultat à être supérieur MaxValueà .

Dans Visual Basic syntaxe d’expression de requête, une clause Aggregate Into Count() se traduit par un appel de Count.

Voir aussi

S’applique à