KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Delegates in `Match` en cultuuronafhankelijke opmaak

Geef `Match` aparte delegates voor succes en fouten met hetzelfde retourtype. Gebruik `FormattableString.Invariant` om interpolatie op te maken zonder afhankelijk te zijn van de huidige cultuur.

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

Syntax

public delegate TResult Func<in T, out TResult>(T arg);

// Delegate parameters of the example's Match<T, TResult>:
Func<T, TResult> onSuccess, Func<string, TResult> onError

// Static method signature on System.FormattableString:
public static string Invariant(FormattableString formattable);

System.Func<T,TResult> is een delegatetype dat één argument van type T aanneemt en TResult retourneert. Func<string,TResult> is hetzelfde generieke type met T ingevuld als string, geen apart API-type en geen overload. Je kunt een compatibele methode of lambda aan de delegate toewijzen. Bij variantieconversies tussen delegates is in T contravariant en out TResult covariant: een Func<object,string> kun je toewijzen aan een Func<string,object>. Variantie geldt voor referentietypen, niet voor waardetypen.

In dit voorbeeld voor C# 12 en .NET 8 is Match een zelfgeschreven hulpfunctie. Ze neemt een Func<T,TResult> voor succes en een Func<string,TResult> voor fouten aan. De operator ?: roept alleen de gekozen delegate aan, geeft die de waarde of de fouttekst mee en retourneert diens TResult. De fouttekst is een gegeven, geen uitzondering. Als de gekozen delegate een uitzondering genereert, vangt de hulpfunctie die niet af.

Als je $"..." rechtstreeks toewijst aan System.FormattableString, blijven de samengestelde opmaak en de al geëvalueerde argumenten bewaard. De opmaak wordt uitgesteld, niet de evaluatie van de expressies. De statische methode FormattableString.Invariant retourneert een string met CultureInfo.InvariantCulture zonder de huidige cultuur te wijzigen. Bij null genereert ze ArgumentNullException. Gewone interpolatie naar string gebruikt standaard de huidige cultuur. Je kunt een al opgemaakte string niet aan Invariant doorgeven om de argumenten terug te halen. Cultuuronafhankelijke opmaak vervangt serialisatie of het escapen van tekens niet.

Voorbeelden

using System;

Func<decimal, string> formatAmount = amount =>
{
    FormattableString message = $"amount={amount:F2}";
    return FormattableString.Invariant(message);
};
Func<string, string> formatError = error => $"error={error}";

Console.WriteLine(Match(true, 12.5m, "missing", formatAmount, formatError));
Console.WriteLine(Match(false, 0m, "missing", formatAmount, formatError));

static TResult Match<T, TResult>(bool succeeded, T value, string error,
    Func<T, TResult> onSuccess, Func<string, TResult> onError)
    => succeeded ? onSuccess(value) : onError(error);

Resultaat

amount=12.50
error=missing

De eerste aanroep voert `formatAmount` uit: `F2` geeft twee decimalen en de invariante cultuur levert de decimale punt in `amount=12.50`. De tweede aanroep voert alleen `formatError` uit en schrijft `error=missing`.

Gerelateerde lessen

  • C# · Les 41 · Gevorderd · Versie: 3

Bronnen