Lire en anglais

Partager via


Enumerable.Count Méthode

Définition

Retourne le nombre total d'éléments dans une séquence.

Surcharges

Count<TSource>(IEnumerable<TSource>)

Retourne le nombre total d'éléments dans une séquence.

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

Retourne un nombre qui représente les éléments de la séquence spécifiée qui satisfont à une condition.

Count<TSource>(IEnumerable<TSource>)

Source:
Count.cs
Source:
Count.cs
Source:
Count.cs

Retourne le nombre total d'éléments dans une séquence.

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

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source
IEnumerable<TSource>

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

Retours

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

Exceptions

source a la valeur null.

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

Exemples

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

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.

Remarques

Si le type d’implémente sourceICollection<T>, cette implémentation est utilisée 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 à dépasser MaxValue.

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

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.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

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

Source:
Count.cs
Source:
Count.cs
Source:
Count.cs

Retourne un nombre qui représente les éléments de la séquence spécifiée qui satisfont à une condition.

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

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source
IEnumerable<TSource>

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

predicate
Func<TSource,Boolean>

Fonction permettant de tester chaque élément par rapport à une condition.

Retours

Nombre qui représente les éléments de la séquence spécifiée qui satisfont à la condition dans la fonction de prédicat.

Exceptions

source ou predicate est null.

Le nombre d’éléments dans 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.

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.

Remarques

Si le type d’implémente sourceICollection<T>, cette implémentation est utilisée 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 à ce que le résultat soit supérieur MaxValueà .

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

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.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