Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes