Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Delegáti v `Match` a formátování nezávislé na jazykové verzi

Předejte funkci `Match` samostatné delegáty pro úspěch a chybu se stejným návratovým typem. Pomocí `FormattableString.Invariant` zformátujete interpolaci nezávisle na aktuálním jazykovém a regionálním nastavení.

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

Syntaxe

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> je typ delegáta, který přijímá jeden argument typu T a vrací TResult. Func<string,TResult> je tentýž obecný typ s T nastaveným na string, nikoli samostatný typ API ani přetížení. Delegátovi lze přiřadit kompatibilní metodu nebo lambda výraz. Při převodech mezi delegáty na základě variance je in T kontravariantní a out TResult kovariantní: Func<object,string> lze přiřadit k Func<string,object>. Variance platí pro referenční typy, ne pro hodnotové typy.

V tomto příkladu pro C# 12 a .NET 8 je Match vlastní pomocná funkce. Přijímá Func<T,TResult> pro úspěch a Func<string,TResult> pro chybu. Operátor ?: zavolá pouze vybraného delegáta, předá mu hodnotu nebo text chyby a vrátí jeho TResult. Text chyby je údaj, nikoli výjimka. Pokud vybraný delegát vyvolá výjimku, funkce ji nezachytí.

Přímé přiřazení $"..." do System.FormattableString uchovává složený formát a již vyhodnocené argumenty: odkládá se formátování, nikoli vyhodnocení výrazů. Statická metoda FormattableString.Invariant vrací string podle CultureInfo.InvariantCulture, aniž změní aktuální jazykové a regionální nastavení. Pro null vyvolá ArgumentNullException. Běžná interpolace do string ve výchozím nastavení používá aktuální jazykové a regionální nastavení. Hotový string nelze předat do Invariant za účelem získání původních argumentů. Invariantní formátování nenahrazuje serializaci ani escapování.

Příklady

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);

Výsledek

amount=12.50
error=missing

První volání spustí `formatAmount`: `F2` určí dvě desetinná místa a invariantní kultura zajistí desetinnou tečku v `amount=12.50`. Druhé volání spustí pouze `formatError` a vypíše `error=missing`.

Související lekce

  • C# · Lekce 41 · Pokročilá · Verze: 3

Zdroje