Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

FormattableString.Invariant — interpolazione con cultura invariante

FormattableString.Invariant formatta gli argomenti di una stringa interpolata usando la cultura invariante e restituisce una stringa. In questo modo la rappresentazione numerica non dipende dalla cultura corrente, pur mantenendo gli specificatori di formato indicati.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

public static string Invariant(FormattableString formattable);

FormattableString.Invariant è un metodo statico dello spazio dei nomi System, disponibile in .NET 10. Accetta un FormattableString e restituisce una string, formattando gli argomenti con CultureInfo.InvariantCulture invece che con la cultura corrente.

Passa direttamente un’espressione interpolata, ad esempio FormattableString.Invariant($"{amount:F2}"), oppure conservala in una variabile di tipo FormattableString. Questo oggetto mantiene formato e argomenti per una formattazione successiva. Al contrario, var text = $"{amount:F2}" crea una string: non puoi passarla a questo metodo e recuperare gli argomenti originali.

Nell’esempio, F2 richiede due cifre decimali e la cultura invariante sceglie il punto come separatore decimale, producendo amount=1234.50. Il metodo non modifica la cultura corrente. La direttiva using static System.FormattableString; permette di abbreviare la chiamata in Invariant(...).

Usa questo approccio per il testo che deve avere una formattazione indipendente dalla cultura; in genere, le interfacce utente dovrebbero rispettare la cultura del pubblico. La cultura invariante non garantisce un’archiviazione senza perdita: F2 può arrotondare i valori. Scegli quindi un formato adatto ai requisiti dei dati.

Esempi

using System;

class Program
{
    static void Main()
    {
        decimal amount = 1234.5m;
        FormattableString template = $"amount={amount:F2}";
        Console.WriteLine(FormattableString.Invariant(template));
    }
}

Risultato

amount=1234.50

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti