CKTIS / C#
FormattableString.Invariant — Interpolation mit invariabler Kultur
FormattableString.Invariant formatiert die Argumente eines interpolierten Textes mit der invariablen Kultur und gibt einen string zurück. So entsteht eine von der aktuellen Kultur unabhängige Zahlendarstellung, wobei die angegebenen Formatspezifizierer erhalten bleiben.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public static string Invariant(FormattableString formattable);FormattableString.Invariant ist eine statische Methode im Namespace System, verfügbar in .NET 10. Sie akzeptiert ein FormattableString und gibt einen string zurück. Dabei formatiert sie die Argumente mit CultureInfo.InvariantCulture statt mit der aktuellen Kultur.
Übergib direkt einen interpolierten Ausdruck, zum Beispiel FormattableString.Invariant($"{amount:F2}"), oder speichere ihn in einer Variablen vom Typ FormattableString. Dieses Objekt bewahrt Format und Argumente für eine spätere Formatierung auf. Dagegen erzeugt var text = $"{amount:F2}" einen string; du kannst ihn nicht an diese Methode übergeben und die ursprünglichen Argumente zurückgewinnen.
Im Beispiel fordert F2 zwei Nachkommastellen an, und die invariante Kultur verwendet einen Dezimalpunkt. Das Ergebnis lautet amount=1234.50. Die Methode ändert die aktuelle Kultur nicht. Mit der Direktive using static System.FormattableString; lässt sich der Aufruf zu Invariant(...) verkürzen.
Verwende diesen Ansatz für Text, dessen Formatierung unabhängig von der Kultur sein muss; Benutzeroberflächen sollten im Allgemeinen die Kultur des Publikums berücksichtigen. Die invariante Kultur garantiert keine verlustfreie Speicherung: F2 kann Werte runden. Wähle daher ein Format, das den Anforderungen der Daten entspricht.
Beispiele
using System;
class Program
{
static void Main()
{
decimal amount = 1234.5m;
FormattableString template = $"amount={amount:F2}";
Console.WriteLine(FormattableString.Invariant(template));
}
}Ergebnis
amount=1234.50
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.