Standardmäßige Zahlenformatanalysegenauigkeit

.NET unterstützt jetzt höhere Genauigkeitswerte beim Formatieren von Zahlen als Zeichenfolgen mit ToString und TryFormat.

Hinweis

Die maximale Genauigkeit wurde in .NET 7 erneut geändert. Weitere Informationen finden Sie unter Maximale Genauigkeit für numerische Formatzeichenfolgen.

Änderungsbeschreibung

Beim Formatieren von Zahlen als Zeichenfolgen stellt der Genauigkeitsspezifizierer in der Formatzeichenfolge die Anzahl der Ziffern in der resultierenden Zeichenfolge dar. Je nach Formatspezifizierer, dem ersten Zeichen in der Zeichenfolge, kann die Genauigkeit die Gesamtzahl der Ziffern, die Anzahl der signifikanten Stellen oder die Anzahl der Dezimalstellen darstellen.

In früheren Versionen von .NET ist die Analyselogik für numerische Standardformate auf eine Genauigkeit von 99 oder weniger beschränkt. Einige numerische Typen haben eine höhere Genauigkeit, die von ToString(string format) jedoch nicht ordnungsgemäß verfügbar gemacht wird. Wenn Sie eine Genauigkeit mehr als 99 angeben (z. B. 32.ToString("C100")), wird die Formatzeichenfolge als benutzerdefinierte numerische Formatzeichenfolge anstelle von „Währung mit Genauigkeit 100“ interpretiert. In benutzerdefinierten numerischen Formatzeichenfolgen werden Zeichen als Zeichenliterale interpretiert. Außerdem wird eine Formatzeichenfolge, die einen ungültigen Formatspezifizierer enthält, je nach Genauigkeitswert unterschiedlich interpretiert. H99 löst eine FormatException-Ausnahme für den ungültigen Formatspezifizierer aus, während H100 als benutzerdefinierte numerische Formatzeichenfolge interpretiert wird.

Ab .NET 6 unterstützt .NET die Genauigkeit bis Int32.MaxValue. Eine Formatzeichenfolge, die aus einem Formatspezifizierer mit einer beliebigen Anzahl von Ziffern besteht, wird als eine dem Standard entsprechende numerische Formatzeichenfolge mit Genauigkeit interpretiert. Eine FormatException-Ausnahme wird für eine oder beide der folgenden Bedingungen ausgelöst:

• Das Formatspezifiziererzeichen ist kein Standardformatspezifizierer.
• Die Genauigkeit ist größer als Int32.MaxValue.

Diese Änderung wurde in der Analyselogik implementiert, die alle numerischen Typen betrifft.

In der folgenden Tabelle sind die Behavior Changes für verschiedene Formatzeichenfolgen aufgeführt.

Formatzeichenfolge	Vorheriges Verhalten	Verhalten ab .NET 6
C2	Bezeichnet eine Währung mit zwei Dezimalstellen	Bezeichnet eine Währung mit zwei Dezimalstellen (keine Änderung)
C100	Bezeichnet eine benutzerdefinierte numerische Formatzeichenfolge, die "C100" ausgibt	Bezeichnet eine Währung mit 100 Dezimalstellen
H99	Löst aufgrund eines ungültigen Standardformatspezifizierers "H" eine FormatException-Ausnahme aus	Löst aufgrund eines ungültigen Standardformatspezifizierers "H" eine FormatException-Ausnahme aus (keine Änderung)
H100	Bezeichnet eine benutzerdefinierte numerische Formatzeichenfolge	Löst aufgrund eines ungültigen Standardformatspezifizierers "H" eine FormatException-Ausnahme aus

Eingeführt in Version

.NET 6

Grund für die Änderung

Durch diese Änderung wird das unerwartete Verhalten korrigiert, das bei einer höheren Genauigkeit der numerischen Formatanalyse auftritt.

Empfohlene Maßnahme

In den meisten Fällen ist keine Maßnahme erforderlich, und die richtige Genauigkeit wird in den resultierenden Zeichenfolgen angezeigt.

Wenn Sie jedoch das vorherige Verhalten wiederherstellen möchten, bei dem der Formatspezifizierer als Literalzeichen interpretiert wird, wenn der Genauigkeitswert über 99 liegt, können Sie dieses Zeichen in einfachen Anführungszeichen umschließen oder mit einem umgekehrten Schrägstrich als Escapezeichen versehen. In früheren Versionen von .NET gibt 42.ToString("G999") beispielsweise G999 zurück. Ändern Sie die Formatzeichenfolge in "'G'999" oder "\\G999", um dieses Verhalten beizubehalten. Dies funktioniert im .NET Framework, in .NET Core sowie in .NET 5 und höher.

Die folgenden Formatzeichenfolgen werden weiterhin als benutzerdefinierte numerische Formatzeichenfolgen interpretiert:

• Beginnt mit einem beliebigen Zeichen, das kein alphabetisches ASCII-Zeichen ist, z. B. $ oder è
• Beginnt mit einem alphabetischen ASCII-Zeichen, auf das keine ASCII-Ziffer folgt, z. B. A$
• Beginnt mit einem alphabetischen ASCII-Zeichen, gefolgt von einer ASCII-Ziffernsequenz und einem beliebigen Zeichen, das kein ASCII-Ziffernzeichen ist, z. B. A12A

Betroffene APIs

Diese Änderung wurde in der Analyselogik implementiert, die alle numerischen Typen betrifft.

• System.Numerics.BigInteger.ToString(String)
• System.Numerics.BigInteger.ToString(String, IFormatProvider)
• System.Numerics.BigInteger.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Int32.ToString(String)
• System.Int32.ToString(String, IFormatProvider)
• System.Int32.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.UInt32.ToString(String)
• System.UInt32.ToString(String, IFormatProvider)
• System.UInt32.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Byte.ToString(String)
• System.Byte.ToString(String, IFormatProvider)
• System.Byte.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.SByte.ToString(String)
• System.SByte.ToString(String, IFormatProvider)
• System.SByte.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Int16.ToString(String)
• System.Int16.ToString(String, IFormatProvider)
• System.Int16.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.UInt16.ToString(String)
• System.UInt16.ToString(String, IFormatProvider)
• System.UInt16.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Int64.ToString(String)
• System.Int64.ToString(String, IFormatProvider)
• System.Int64.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.UInt64.ToString(String)
• System.UInt64.ToString(String, IFormatProvider)
• System.UInt64.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Half.ToString(String)
• System.Half.ToString(String, IFormatProvider)
• System.Half.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Single.ToString(String)
• System.Single.ToString(String, IFormatProvider)
• System.Single.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Double.ToString(String)
• System.Double.ToString(String, IFormatProvider)
• System.Double.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
• System.Decimal.ToString(String)
• System.Decimal.ToString(String, IFormatProvider)
• System.Decimal.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

Siehe auch

• Standardmäßige Zahlenformatzeichenfolgen
• Zeichenliterale in benutzerdefinierten Formatzeichenfolgen
• Maximale Genauigkeit für numerische Formatzeichenfolgen (.NET 7)