CKTIS / C#
FormattableString.Invariant — interpolación con cultura invariable
FormattableString.Invariant da formato a los argumentos de una cadena interpolada usando la cultura invariable y devuelve una cadena. Así, la representación numérica no depende de la cultura actual y se conservan los especificadores de formato indicados.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
public static string Invariant(FormattableString formattable);FormattableString.Invariant es un método estático del espacio de nombres System, disponible en .NET 10. Acepta un FormattableString y devuelve un string; da formato a los argumentos usando CultureInfo.InvariantCulture en lugar de la cultura actual.
Pasa directamente una expresión interpolada, como FormattableString.Invariant($"{amount:F2}"), o guárdala en una variable de tipo FormattableString. Este objeto conserva el formato y los argumentos para darles formato más adelante. En cambio, var text = $"{amount:F2}" crea un string; no puedes pasarlo a este método y recuperar los argumentos originales.
En el ejemplo, F2 solicita dos posiciones decimales y la cultura invariable elige un punto decimal, por lo que se obtiene amount=1234.50. El método no cambia la cultura actual. La directiva using static System.FormattableString; permite abreviar la llamada como Invariant(...).
Usa este enfoque para texto cuyo formato deba ser independiente de la cultura; por lo general, las interfaces de usuario deberían respetar la cultura del público. La cultura invariable no garantiza un almacenamiento sin pérdida: F2 puede redondear valores. Elige un formato adecuado a los requisitos de los datos.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.