WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Func<bool> und Action<int>: Signalklassifizierung und onAfterUnit

Mit `Func<bool>` prüfst du Regeln zur Signalklassifizierung. Mit `Action<int>` benachrichtigst du den Aufrufer nach der Verarbeitung einer Einheit.

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

Syntax

static void ProcessUnit(int unitIndex, Func<bool> isHigh, Func<bool> isLow, Action<int>? onAfterUnit = null)
{
    string label = isHigh() ? "high" : isLow() ? "low" : "normal";
    Console.WriteLine(label);
    onAfterUnit?.Invoke(unitIndex);
}

Func<bool> und Action<int> sind Delegattypen im Namespace System. Der erste nimmt keine Argumente entgegen und gibt einen bool-Wert zurück. Der zweite nimmt einen int-Wert entgegen und gibt nichts zurück (void). Soll eine Regel den Messwert ausdrücklich als Argument erhalten, verwende Func<int, bool>. Der nicht generische Typ Action nimmt keine Argumente entgegen.

Im Beispiel für C# 12 und .NET 8 erhält ProcessUnit zwei Delegaten zur Klassifizierung: isHigh und isLow. Zuerst ruft die Methode isHigh() auf. Bei true wählt sie high und überspringt isLow(). Andernfalls bestimmt isLow(), ob die Bezeichnung low oder normal lautet. Die Lambdas erfassen die in diesem Schleifendurchlauf angelegte Variable reading, keine Kopie ihres Werts. Wird ein Delegat aufbewahrt, kann das die Lebensdauer der erfassten Variable verlängern.

Nach der Ausgabe der Klassifizierung ruft onAfterUnit?.Invoke(unitIndex) den optionalen Callback mit dem nullbasierten Index der Einheit auf, nicht mit dem Messwert. Action<int>? erlaubt null, = null macht das Argument optional, und ?. überspringt den Aufruf bei null. ProcessUnit ist eine Beispielmethode; onAfterUnit ist ihr Parameter, kein Ereignis und kein Bestandteil der .NET-API.

Delegaten werden synchron aufgerufen. Löst eine Regel oder die Ausgabe eine Ausnahme aus, wird der Callback nicht erreicht. Löst der Callback selbst eine Ausnahme aus, wird sie an den Aufrufer weitergegeben. ?. fängt keine Ausnahmen ab. Mit += wird der Variablen ein Delegat mit einer kombinierten Aufrufliste zugewiesen, ohne eine Methode auszuführen. Erst beim Aufruf dieses Delegaten werden die Methoden der Reihe nach ausgeführt. Löst eine Methode eine Ausnahme aus, werden die verbleibenden Methoden nicht aufgerufen. Endet der Aufruf ohne Ausnahme, gibt ein kombinierter Func<bool> nur das Ergebnis der letzten Methode zurück, keine logische Verknüpfung der Ergebnisse. Akzeptiere Delegaten nur aus vertrauenswürdigem Code: Ihr Typ legt die Signatur fest, schränkt aber Seiteneffekte nicht ein.

Beispiele

using System;

int[] readings = { 12, -3, 4 };
Action<int> onAfterUnit = static index =>
    Console.WriteLine(FormattableString.Invariant($"after unit {index}"));

for (int i = 0; i < readings.Length; i++)
{
    int reading = readings[i];
    Func<bool> isHigh = () => reading >= 10;
    Func<bool> isLow = () => reading < 0;

    ProcessUnit(i, isHigh, isLow, onAfterUnit);
}

static void ProcessUnit(int unitIndex, Func<bool> isHigh, Func<bool> isLow,
    Action<int>? onAfterUnit = null)
{
    string label = isHigh() ? "high" : isLow() ? "low" : "normal";
    Console.WriteLine(label);
    onAfterUnit?.Invoke(unitIndex);
}

Ergebnis

high
after unit 0
low
after unit 1
normal
after unit 2

Für die Messwerte `12`, `-3` und `4` werden der Reihe nach `high`, `low` und `normal` erwartet. Auf jede Bezeichnung folgt eine Zeile `after unit` mit dem Index der Einheit.

Zugehörige Lektionen

  • C# · Lektion 21 · Fortgeschritten · Version: 3

Quellen