CKTIS / C#
Die Delegaten Action<T>, Func<T,TResult> und Predicate<T>
Speichere Verhalten in Variablen und übergib es als Argument: Action führt eine Operation aus, Func liefert ein Ergebnis und Predicate prüft eine Bedingung.
Version: 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 und .NET 8 sind dies vordefinierte generische Delegattypen im Namespace System. Die Syntax zeigt vorhandene Bibliotheksdeklarationen; deklariere sie nicht erneut. Wähle den Typ danach aus, was der aufrufende Code benötigt.
Action<T> nimmt ein Argument vom Typ T entgegen und gibt keinen Wert zurück (void), etwa bei einer Textausgabe. Func<T,TResult> nimmt ein Argument vom Typ T entgegen und gibt TResult zurück; der letzte Typparameter ist der Ergebnistyp. Predicate<T> nimmt ein Argument vom Typ T entgegen und gibt bool zurück: true, wenn das Element die Bedingung erfüllt, sonst false.
Einer Delegatvariablen kannst du ein kompatibles Lambda (=>) oder eine Methodengruppe wie Console.WriteLine ohne Klammern zuweisen. Der Zieltyp Action<string> hilft dem Compiler, die Überladung mit einem string-Parameter auszuwählen. Weder die Zuweisung noch die Übergabe des Delegaten führt seinen Code aus; erst ein Aufruf wie format(word) tut das.
Predicate<T> und Func<T,bool> haben dieselbe Aufrufsignatur, sind aber verschiedene Typen. List<T>.FindAll erwartet Predicate<T> und gibt sofort eine neue Liste zurück. Enumerable.Where erwartet Func<T,bool> oder in der Überladung mit Index Func<T,int,bool>; gefiltert wird beim Durchlaufen der Sequenz. Eine vorhandene Predicate<T>-Variable kannst du nicht direkt an Where übergeben; verwende ein Lambda wie item => matches(item).
In den Deklarationen steht in T für Kontravarianz der Eingabe und out TResult für Kovarianz des Ergebnisses. Diese Varianzkonvertierungen gelten für Referenztypen, nicht für int. Ein static-Lambda kann nichts erfassen; eine von einem nichtstatischen Lambda erfasste Variable kann ihren Block überdauern. Der direkte Aufruf eines null-Delegaten löst NullReferenceException aus; FindAll weist ein null-Prädikat mit ArgumentNullException zurück.
Beispiele
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));
}
}Ergebnis
item: pear item: kiwi
`ReportMatches` erhält drei Delegaten. `FindAll` ruft `matches` für jedes Wort auf und behält `pear` und `kiwi`. Dann fügt `format` das Präfix `item: ` hinzu, und `report` gibt eine Zeile pro Wort aus.
Zugehörige Lektionen
- C# · Lektion 21 · Mittlere Stufe · Version: 2
Quellen
- 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