CKTIS / C#
Func-Delegaten und kulturunabhängige Berichtsformatierung
Elemente mit einem bool-Delegaten filtern, die ausgewählten decimal-Beträge summieren und erst danach den Bericht unabhängig von der aktuellen Kultur formatieren.
Version: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
Func<Item, bool> predicate = item => item.Included;
Func<Item, decimal> selector = item => item.Amount;
decimal total = items.Where(predicate).Sum(selector);
FormattableString report = $"Total={total:F2}";
string text = FormattableString.Invariant(report);System.Func<T, TResult> ist ein Delegattyp mit einem Argument vom Typ T und einem Ergebnis vom Typ TResult. Item ist der im Beispiel definierte Typ. Func<Item, bool> ist ein Prädikat: true bedeutet, dass das Element übernommen wird. Func<Item, decimal> ist ein Selektor: Er liefert den Betrag des Elements. Beiden lassen sich Lambdas mit => zuweisen, doch die Typen sind nicht austauschbar.
In System.Linq nimmt die Überladung von Enumerable.Where ohne Index das Prädikat entgegen. Gefiltert wird erst beim Durchlaufen der Sequenz. Sum(selector) durchläuft diese Sequenz und addiert die Beträge passender Elemente mit der Überladung für decimal, nicht decimal?. Ohne Treffer ergibt sich null als Zahl; ein Überlauf löst OverflowException aus.
Eine Interpolation, die System.FormattableString zugewiesen wird, behält Format und Argumente. ToString() verwendet die aktuelle Kultur, ToString(IFormatProvider) den angegebenen Formatanbieter. Die statische Methode FormattableString.Invariant nimmt ein FormattableString-Objekt entgegen, liefert einen mit der invarianten Kultur formatierten string und löst bei null eine ArgumentNullException aus. Übergib die Interpolation direkt oder behalte sie als FormattableString; ein bereits formatierter string lässt sich damit nicht neu formatieren.
F2 zeigt zwei Nachkommastellen ohne Zifferngruppierung an, ohne den decimal-Wert zu ändern. Für lokalisierte Anzeigen eignet sich die Kultur des Benutzers, für Berichte mit festem Dezimaltrennzeichen die invariante Kultur. Diese Formatierung ersetzt weder Serialisierung noch die vom Zielformat verlangte Maskierung.
Beispiele
using System;
using System.Globalization;
using System.Linq;
Item[] items =
[
new Item(true, 12.50m),
new Item(false, 99.00m),
new Item(true, 7.90m)
];
Func<Item, bool> predicate = item => item.Included;
Func<Item, decimal> selector = item => item.Amount;
decimal total = items.Where(predicate).Sum(selector);
FormattableString report = $"Total={total:F2}";
var customCulture = (CultureInfo)CultureInfo.InvariantCulture.Clone();
customCulture.NumberFormat.NumberDecimalSeparator = ",";
Console.WriteLine("Custom: " + report.ToString(customCulture));
Console.WriteLine("Invariant: " + FormattableString.Invariant(report));
internal sealed record Item(bool Included, decimal Amount);
Ergebnis
Custom: Total=20,40 Invariant: Total=20.40
Das Element mit `99.00` wird ausgeschlossen. Dieselbe Summe erscheint mit Komma, wenn eine modifizierte Kopie der invarianten Kultur ausdrücklich übergeben wird, und mit Punkt bei `Invariant`. Die aktuelle Kultur bleibt unverändert.
Zugehörige Lektionen
- C# · Lektion 25 · Fortgeschritten · Version: 3
Quellen
- Func<T,TResult> Delegate (System)
- Enumerable.Where Method (System.Linq)
- Enumerable.Sum Method (System.Linq)
- FormattableString.Invariant(FormattableString) Method (System)
- FormattableString.ToString Method (System)
- $ - string interpolation - format string output - C# reference
- Standard numeric format strings - .NET
- Best practices for displaying and persisting formatted data in .NET