Enumerable.MinBy Méthode

Définition

Espace de noms:

System.Linq

Assemblys:

netstandard.dll, System.Linq.dll

Surcharges

Nom	Description
MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Retourne la valeur minimale dans une séquence générique en fonction d’une fonction de sélecteur de clé spécifiée.
MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Retourne la valeur minimale dans une séquence générique en fonction d’une fonction de sélecteur de clé et d’un comparateur de clés spécifiés.

MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Source:

Min.cs

Retourne la valeur minimale dans une séquence générique en fonction d’une fonction de sélecteur de clé spécifiée.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static TSource MinBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);

public static TSource? MinBy<TSource,TKey>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

static member MinBy : seq<'Source> * Func<'Source, 'Key> -> 'Source

<Extension()>
Public Function MinBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As TSource

Paramètres de type

TSource

Type des éléments de source.

TKey

Type de clé par lequel comparer les éléments.

Paramètres

source

IEnumerable<TSource>

Séquence de valeurs pour déterminer la valeur minimale de.

keySelector

Func<TSource,TKey>

Fonction permettant d’extraire la clé de chaque élément.

Retours

TSource

Valeur avec la clé minimale dans la séquence.

Exceptions

ArgumentNullException

source a la valeur null.

ArgumentException

Aucune clé extraite d’implémente source l’interface ou IComparable<T> l’interfaceIComparable.

InvalidOperationException

TSource est un type primitif et la séquence source est vide.

Exemples

L’exemple de code suivant montre comment rechercher MinBy la valeur minimale dans une collection en fonction d’une propriété spécifique.

(string Name, decimal Salary, int Age)[] employees =
{
    ("Mahmoud", 1000m, 22),
    ("John", 1200m, 28),
    ("Sara", 2000m, 32),
    ("Hadi", 1750m, 27),
    ("Lana", 1500m, 24),
    ("Luna", 1850m, 33)
};

// Get the youngest employee in the company.
var youngestEmployee = employees.MinBy(employee => employee.Age);

Console.WriteLine($"Name: {youngestEmployee.Name}, Age: {youngestEmployee.Age}, Salary: ${youngestEmployee.Salary}");

/*
This code produces the following output:

Name: Mahmoud, Age: 22, Salary: $1000
*/

</Format>

Remarques

Si la séquence source est vide, deux résultats possibles sont possibles en fonction du type source. S’il TSource s’agit d’un type nullable, cette méthode retourne null. S’il TSource s’agit d’un struct non nullable, tel qu’un type primitif, un InvalidOperationException objet est levée.

Si la séquence source contient uniquement des valeurs qui sont null, cette méthode retourne null.

<format type="text/markdown »>

MinBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

Source:

Min.cs

Retourne la valeur minimale dans une séquence générique en fonction d’une fonction de sélecteur de clé et d’un comparateur de clés spécifiés.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static TSource MinBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);

public static TSource? MinBy<TSource,TKey>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

static member MinBy : seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> 'Source

<Extension()>
Public Function MinBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IComparer(Of TKey)) As TSource

Paramètres de type

TSource

Type des éléments de source.

TKey

Type de clé par lequel comparer les éléments.

Paramètres

source

IEnumerable<TSource>

Séquence de valeurs pour déterminer la valeur minimale de.

keySelector

Func<TSource,TKey>

Fonction permettant d’extraire la clé de chaque élément.

comparer

IComparer<TKey>

Pour IComparer<T> comparer les clés.

Retours

TSource

Valeur avec la clé minimale dans la séquence.

Exceptions

ArgumentNullException

source a la valeur null.

ArgumentException

Aucune clé extraite d’implémente source l’interface ou IComparable<T> l’interfaceIComparable.

InvalidOperationException

TSource est un type primitif et la séquence source est vide.

Exemples

L’exemple de code suivant montre comment utiliser MinBy un comparateur personnalisé pour ignorer la sensibilité de la casse lors de la vérification de la valeur minimale.

(string Name, int Quantity)[] inventory =
{
    ("apple", 10),
    ("BANANA", 5),
    ("Cherry", 20)
};

// Find the product with the minimum name alphabetically, ignoring casing differences.
// 'a' is correctly identified as smaller than 'B' when case is ignored.
var minIgnoreCase = inventory.MinBy(item => item.Name, StringComparer.OrdinalIgnoreCase);
Console.WriteLine($"Case-insensitive comparison: {minIgnoreCase.Name}");

/*
This code produces the following output:

Case-insensitive comparison: apple
*/

</Format>

Remarques

Si la séquence source est vide, deux résultats possibles sont possibles en fonction du type source. S’il TSource s’agit d’un type nullable, cette méthode retourne null. S’il TSource s’agit d’un struct non nullable, tel qu’un type primitif, un InvalidOperationException objet est levée.

Si la séquence source contient uniquement des valeurs qui sont null, cette méthode retourne null.

<format type="text/markdown »>