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.