Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C#

Delegados em `Match` e formatação independente da cultura

Passa a `Match` dois delegados com o mesmo tipo de retorno, um para o sucesso e outro para o erro. Usa `FormattableString.Invariant` para formatar uma interpolação sem depender da cultura atual.

Versão: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxe

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> é um tipo de delegado que recebe um argumento de tipo T e devolve TResult. Func<string,TResult> é o mesmo tipo genérico com T fixado em string, não um tipo de API distinto nem uma sobrecarga. Podes atribuir-lhe um método compatível ou uma expressão lambda. Nas conversões por variância entre delegados, in T é contravariante e out TResult é covariante: um Func<object,string> pode ser atribuído a um Func<string,object>. A variância aplica-se aos tipos de referência, não aos tipos de valor.

Neste exemplo para C# 12 e .NET 8, Match é uma função auxiliar definida no código. Recebe um Func<T,TResult> para o sucesso e um Func<string,TResult> para o erro. O operador ?: invoca apenas o delegado selecionado, passa-lhe o valor ou o texto do erro e devolve o seu TResult. O texto do erro é um dado, não uma exceção. Se o delegado selecionado lançar uma exceção, a função não a interceta.

Atribuir $"..." diretamente a System.FormattableString preserva o formato composto e os argumentos já avaliados: adia-se a formatação, não a avaliação das expressões. O método estático FormattableString.Invariant devolve uma string usando CultureInfo.InvariantCulture, sem alterar a cultura atual. Se receber null, lança ArgumentNullException. A interpolação normal para string usa, por predefinição, a cultura atual. Não podes passar uma string já formatada a Invariant para recuperar os seus argumentos. A formatação invariante não substitui a serialização nem o escape de caracteres.

Exemplos

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

Resultado

amount=12.50
error=missing

A primeira chamada executa `formatAmount`: `F2` dá duas casas decimais e a cultura invariante dá o ponto decimal em `amount=12.50`. A segunda chamada executa apenas `formatError` e escreve `error=missing`.

Lições relacionadas

  • C# · Lição 41 · Avançado · Versão: 3

Fontes