Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

Les délégués Action<T>, Func<T,TResult> et Predicate<T>

Stockez un comportement dans une variable et passez-le en argument : Action effectue une opération, Func renvoie un résultat et Predicate teste une condition.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

public delegate void Action<in T>(T obj);
public delegate TResult Func<in T, out TResult>(T arg);
public delegate bool Predicate<in T>(T obj);

En C# 12 et .NET 8, ces types délégués génériques sont prédéfinis dans l’espace de noms System. La syntaxe présente les déclarations de la bibliothèque : ne les redéclarez pas. Choisissez le type adapté aux besoins du code appelant.

Action<T> prend un argument de type T et ne renvoie aucune valeur (void), par exemple pour afficher du texte. Func<T,TResult> prend un argument de type T et renvoie TResult ; le dernier paramètre de type indique le type du résultat. Predicate<T> prend un argument de type T et renvoie un bool : true si l’élément satisfait la condition, sinon false.

Affectez à une variable déléguée une expression lambda compatible (=>) ou un groupe de méthodes, comme Console.WriteLine sans parenthèses. Le type cible Action<string> aide le compilateur à sélectionner la surcharge qui prend un string. Affecter ou passer un délégué en argument n’exécute pas son code ; c’est l’appel, par exemple format(word), qui l’exécute.

Predicate<T> et Func<T,bool> ont la même signature d’appel, mais sont deux types distincts. List<T>.FindAll attend un Predicate<T> et renvoie immédiatement une nouvelle liste. Enumerable.Where attend un Func<T,bool> ou, dans la surcharge avec indice, un Func<T,int,bool> ; le filtrage a lieu lors du parcours de la séquence. Vous ne pouvez pas passer directement à Where une variable de type Predicate<T> ; utilisez une lambda comme item => matches(item).

Dans les déclarations, in T indique la contravariance de l’entrée et out TResult la covariance du résultat. Ces conversions de variance s’appliquent aux types référence, pas à int. Une lambda static ne peut rien capturer ; une variable capturée par une lambda non statique peut survivre à son bloc. L’appel direct d’un délégué null lève NullReferenceException ; FindAll rejette un prédicat null en levant ArgumentNullException.

Exemples

using System;
using System.Collections.Generic;

List<string> words = new() { "a", "pear", "kiwi" };
Predicate<string> matches = static word => word.Length >= 4;
Func<string, string> format = static word => $"item: {word}";
Action<string> report = Console.WriteLine;

ReportMatches(words, matches, format, report);

static void ReportMatches(
    List<string> words,
    Predicate<string> matches,
    Func<string, string> format,
    Action<string> report)
{
    foreach (string word in words.FindAll(matches))
    {
        report(format(word));
    }
}

Résultat

item: pear
item: kiwi

`ReportMatches` reçoit trois délégués. `FindAll` appelle `matches` pour chaque mot et conserve `pear` et `kiwi`. Ensuite, `format` ajoute le préfixe `item: ` et `report` affiche une ligne par mot.

Leçons associées

  • C# · Leçon 21 · Intermédiaire · Version : 2

Sources