CKTIS / C#
Delegados Func e formatação de relatórios com cultura invariante
Filtre elementos com um delegado que devolve bool, some os montantes decimal selecionados e formate o relatório sem depender da cultura atual.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
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> é um tipo de delegado que recebe um argumento de tipo T e devolve um resultado de tipo TResult. Item é o tipo definido no exemplo. Func<Item, bool> é um predicado: true indica que o elemento é mantido. Func<Item, decimal> é um seletor: devolve o montante do elemento. É possível atribuir lambdas escritas com => a ambos, mas os tipos não são intercambiáveis.
Em System.Linq, a sobrecarga de Enumerable.Where sem índice recebe o predicado e adia a filtragem até à enumeração da sequência. Sum(selector) enumera essa sequência e soma os montantes dos elementos aceites, usando a sobrecarga que devolve decimal, não decimal?. Se nenhum elemento corresponder, o resultado é zero; se uma adição produzir um valor fora do intervalo de decimal, é lançada uma OverflowException.
Uma interpolação atribuída a System.FormattableString conserva o formato e os argumentos. ToString() usa a cultura atual; ToString(IFormatProvider) usa o fornecedor especificado. O método estático FormattableString.Invariant recebe um FormattableString, devolve um string formatado com a cultura invariante e lança ArgumentNullException para null. Passe a interpolação diretamente ou mantenha-a como FormattableString; o método não pode voltar a formatar um string já produzido.
F2 apresenta duas casas decimais sem agrupar algarismos e não altera o valor decimal. Use a cultura do utilizador para uma apresentação localizada e a cultura invariante se o relatório exigir um separador decimal fixo. Esta formatação não substitui a serialização nem o escape exigido pelo formato de destino.
Exemplos
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);
Resultado
Custom: Total=20,40 Invariant: Total=20.40
O elemento com o montante `99.00` é excluído. O mesmo total é apresentado com vírgula ao passar explicitamente uma cópia modificada da cultura invariante e com ponto ao usar `Invariant`. O programa não altera a cultura atual.
Lições relacionadas
- C# · Lição 25 · Avançado · Versão: 3
Fontes
- 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