CKTIS / C#
FormattableString.Invariant — interpolação com cultura invariável
FormattableString.Invariant formata os argumentos de uma cadeia interpolada usando a cultura invariável e devolve uma cadeia. Assim, a representação dos números não depende da cultura atual, mantendo os especificadores de formato indicados.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public static string Invariant(FormattableString formattable);FormattableString.Invariant é um método estático do espaço de nomes System, disponível no .NET 10. Aceita um FormattableString e devolve uma string, formatando os argumentos com CultureInfo.InvariantCulture em vez da cultura atual.
Passe diretamente uma expressão interpolada, como FormattableString.Invariant($"{amount:F2}"), ou guarde-a numa variável do tipo FormattableString. Este objeto preserva o formato e os argumentos para formatação posterior. Em contrapartida, var text = $"{amount:F2}" cria uma string; não pode passá-la a este método e recuperar os argumentos originais.
No exemplo, F2 pede duas casas decimais e a cultura invariável escolhe um ponto decimal, produzindo amount=1234.50. O método não altera a cultura atual. A diretiva using static System.FormattableString; permite encurtar a chamada para Invariant(...).
Use esta abordagem para texto cuja formatação tenha de ser independente da cultura; em geral, as interfaces de utilizador devem respeitar a cultura do público. A cultura invariável não garante um armazenamento sem perdas: F2 pode arredondar valores. Escolha, por isso, um formato adequado aos requisitos dos dados.
Exemplos
using System;
class Program
{
static void Main()
{
decimal amount = 1234.5m;
FormattableString template = $"amount={amount:F2}";
Console.WriteLine(FormattableString.Invariant(template));
}
}Resultado
amount=1234.50
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.