Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Delegaty w `Match` i formatowanie niezależne od kultury

Przekaż do `Match` osobne delegaty dla sukcesu i błędu, zwracające ten sam typ. Użyj `FormattableString.Invariant`, aby sformatować interpolację niezależnie od bieżącej kultury.

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

Składnia

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> to typ delegata, który przyjmuje jeden argument typu T i zwraca TResult. Func<string,TResult> to ten sam typ generyczny z T ustalonym na string, a nie odrębny typ API ani przeciążenie. Do delegata można przypisać zgodną metodę lub lambdę. W konwersjach wariancyjnych delegatów in T jest kontrawariantny, a out TResult kowariantny: Func<object,string> można przypisać do Func<string,object>. Wariancja działa dla typów referencyjnych, nie dla typów wartościowych.

W C# 12 i .NET 8 pokazany Match to funkcja pomocnicza zdefiniowana w przykładzie. Przyjmuje Func<T,TResult> dla sukcesu oraz Func<string,TResult> dla błędu. Operator ?: wywołuje tylko wybrany delegat: przekazuje mu wartość albo tekst błędu i zwraca jego TResult. Tekst błędu jest daną, nie wyjątkiem; jeśli wybrany delegat zgłosi wyjątek, funkcja go nie przechwytuje.

Bezpośrednie przypisanie interpolacji $"..." do System.FormattableString zachowuje format złożony i obliczone już argumenty, odkładając formatowanie, a nie obliczanie wyrażeń. Statyczna metoda FormattableString.Invariant zwraca string zgodny z CultureInfo.InvariantCulture, bez zmiany bieżącej kultury; dla null zgłasza ArgumentNullException. Zwykła interpolacja do string używa domyślnie bieżącej kultury. Gotowego string nie można przekazać do Invariant, aby odzyskać argumenty. Formatowanie niezależne od kultury nie zastępuje serializacji ani uciekania znaków.

Przykłady

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

Wynik

amount=12.50
error=missing

Pierwsze wywołanie uruchamia `formatAmount`: `F2` daje dwa miejsca po przecinku, a kultura niezmienna daje kropkę w `amount=12.50`. Drugie uruchamia wyłącznie `formatError` i wypisuje `error=missing`.

Powiązane lekcje

  • C# · Lekcja 41 · Zaawansowany · Wersja: 3

Źródła