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

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.

Fontes