Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

FormattableString.Invariant — interpolation avec culture invariante

FormattableString.Invariant met en forme les arguments d’une chaîne interpolée avec la culture invariante et renvoie une chaîne. La représentation des nombres ne dépend ainsi pas de la culture actuelle, tout en conservant les spécificateurs de format fournis.

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

Syntaxe

public static string Invariant(FormattableString formattable);

FormattableString.Invariant est une méthode statique de l’espace de noms System, disponible dans .NET 10. Elle accepte un FormattableString et renvoie une string, en mettant en forme les arguments avec CultureInfo.InvariantCulture plutôt qu’avec la culture actuelle.

Passez-lui directement une expression interpolée, par exemple FormattableString.Invariant($"{amount:F2}"), ou conservez cette expression dans une variable de type FormattableString. Cet objet préserve le format et les arguments pour une mise en forme ultérieure. En revanche, var text = $"{amount:F2}" crée une string : vous ne pouvez pas la transmettre à cette méthode pour récupérer les arguments d’origine.

Dans l’exemple, F2 demande deux décimales et la culture invariante choisit un point comme séparateur décimal, ce qui produit amount=1234.50. La méthode ne modifie pas la culture actuelle. La directive using static System.FormattableString; permet de raccourcir l’appel en Invariant(...).

Utilisez cette approche pour les textes dont le format doit être indépendant de la culture ; les interfaces utilisateur devraient généralement respecter la culture du public visé. La culture invariante ne garantit pas un stockage sans perte : F2 peut arrondir les valeurs. Choisissez donc un format adapté aux exigences des données.

Exemples

using System;

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

Résultat

amount=1234.50

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources