CKTIS / C#
De delegates Action<T>, Func<T,TResult> en Predicate<T>
Sla gedrag op in variabelen en geef het door als argument: Action voert een bewerking uit, Func geeft een resultaat terug en Predicate test een voorwaarde.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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);In C# 12 en .NET 8 zijn dit vooraf gedefinieerde generieke delegatetypen in de naamruimte System. De syntax toont de bestaande bibliotheekdeclaraties; declareer ze niet opnieuw. Kies het type dat past bij wat de aanroepende code nodig heeft.
Action<T> neemt één argument van type T aan en geeft geen waarde terug (void), bijvoorbeeld bij het afdrukken van tekst. Func<T,TResult> neemt één argument van type T aan en geeft TResult terug; de laatste typeparameter geeft het resultaattype aan. Predicate<T> neemt één argument van type T aan en geeft een bool terug: true als het element aan de voorwaarde voldoet, anders false.
Wijs een compatibele lambda (=>) of een methodegroep zoals Console.WriteLine zonder haakjes toe aan een delegatevariabele. Het doeltype Action<string> helpt de compiler de overload te kiezen die een string aanneemt. Toewijzen of doorgeven als argument voert de code niet uit; een aanroep zoals format(word) doet dat wel.
Predicate<T> en Func<T,bool> hebben dezelfde aanroepsignatuur, maar zijn verschillende typen. List<T>.FindAll verwacht een Predicate<T> en geeft meteen een nieuwe lijst terug. Enumerable.Where verwacht een Func<T,bool> of, in de overload met index, een Func<T,int,bool>; filteren gebeurt bij het doorlopen van de reeks. Je kunt een bestaande Predicate<T>-variabele niet rechtstreeks aan Where doorgeven; gebruik een lambda zoals item => matches(item).
In de declaraties maakt in T de invoer contravariant en out TResult het resultaat covariant. Deze variantieconversies gelden voor referentietypen, niet voor int. Een static-lambda kan niets vastleggen; een variabele die door een niet-statische lambda is vastgelegd, kan langer blijven bestaan dan haar blok. Het rechtstreeks aanroepen van een null-delegate veroorzaakt NullReferenceException; FindAll wijst een null-predicaat af met ArgumentNullException.
Voorbeelden
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));
}
}Resultaat
item: pear item: kiwi
`ReportMatches` ontvangt drie delegates. `FindAll` roept `matches` aan voor elk woord en behoudt `pear` en `kiwi`. Daarna voegt `format` het voorvoegsel `item: ` toe en drukt `report` één regel per woord af.
Gerelateerde lessen
- C# · Les 21 · Gemiddeld · Versie: 2
Bronnen
- Action<T> Delegate (System)
- Func<T,TResult> Delegate (System)
- Predicate<T> Delegate (System)
- List<T>.FindAll(Predicate<T>) Method (System.Collections.Generic)
- Enumerable.Where Method (System.Linq)
- Lambda expressions and anonymous functions
- Variance in Delegates (C#)
- Delegates — C# language specification
- Language versioning — C# reference