WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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