Single.TryParse Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wandelt die Zeichenfolgendarstellung einer Zahl in die Gleitkommazahl mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
Überlädt
TryParse(String, IFormatProvider, Single) |
Versucht, eine Zeichenfolge in einen Wert zu analysieren. |
TryParse(ReadOnlySpan<Char>, Single) |
Wandelt die Zeichenfolgendarstellung einer Zahl in einer Zeichenspanne in die Gleitkommazahl mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist. |
TryParse(String, Single) |
Wandelt die Zeichenfolgendarstellung einer Zahl in die Gleitkommazahl mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single) |
Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, Single) |
Versucht, einen Bereich von Zeichen in einen Wert zu analysieren. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single) |
Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren. |
TryParse(ReadOnlySpan<Byte>, Single) |
Versucht, einen UTF-8-Zeichenbereich zu konvertieren, der die Zeichenfolgendarstellung einer Zahl in seine Gleitkommazahlenentsprechung mit einfacher Genauigkeit enthält. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single) |
Wandelt die Spandarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format in dessen Gleitkommazahlenäquivalent mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist. |
TryParse(String, NumberStyles, IFormatProvider, Single) |
Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in dessen Gleitkommazahlenentsprechung mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist. |
Hinweise
In .NET Core 3.0 und höher werden werte, die zu groß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.
TryParse(String, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Versucht, eine Zeichenfolge in einen Wert zu analysieren.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = IParsable<float>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out float result);
static member TryParse : string * IFormatProvider * single -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- s
- String
Die zu analysierende Zeichenfolge.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse s
oder eines nicht definierten Werts für fehler.
Gibt zurück
true
, wenn s
erfolgreich analysiert wurde; andernfalls false
.
Gilt für:
TryParse(ReadOnlySpan<Char>, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Wandelt die Zeichenfolgendarstellung einer Zahl in einer Zeichenspanne in die Gleitkommazahl mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<char> s, out float result);
static member TryParse : ReadOnlySpan<char> * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Single) As Boolean
Parameter
- s
- ReadOnlySpan<Char>
>Ein Zeichenbereich, der die Zeichenfolgendarstellung der zu konvertierenden Zahl enthält.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit des s
Parameters, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter s
null
oder leer ist oder keine Zahl in einem gültigen Format ist. Wenn s
eine gültige Zahl kleiner als Single.MinValue-ist, ist result
NegativeInfinity. Wenn s
eine gültige Zahl größer als Single.MaxValue-ist, ist result
PositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result
angegebenen Werte werden überschrieben.
Gibt zurück
true
, wenn s
erfolgreich konvertiert wurde; andernfalls false
.
Hinweise
In .NET Core 3.0 und höher werden werte, die zu groß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.
Gilt für:
TryParse(String, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Wandelt die Zeichenfolgendarstellung einer Zahl in die Gleitkommazahl mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (string s, out float result);
public static bool TryParse (string? s, out float result);
static member TryParse : string * single -> bool
Public Shared Function TryParse (s As String, ByRef result As Single) As Boolean
Parameter
- s
- String
Eine Zeichenfolge, die eine zahl darstellt, die konvertiert werden soll.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält eine Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol entspricht, der in s
enthalten ist, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter s
null
oder Empty ist oder keine Zahl in einem gültigen Format ist. Es schlägt auch unter .NET Framework und .NET Core 2.2 und früheren Versionen fehl, wenn s
eine Zahl kleiner als Single.MinValue- oder größer als Single.MaxValue-darstellt. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result
angegebenen Werte werden überschrieben.
Gibt zurück
true
, wenn s
erfolgreich konvertiert wurde; andernfalls false
.
Beispiele
Im folgenden Beispiel wird die TryParse(String, Single)-Methode verwendet, um die Zeichenfolgendarstellungen numerischer Werte in Single Werte zu konvertieren. Es wird davon ausgegangen, dass en-US die aktuelle Kultur ist.
string value;
float number;
// Parse a floating-point value with a thousands separator.
value = "1,643.57";
if (Single.TryParse(value, out number))
Console.WriteLine(number);
else
Console.WriteLine("Unable to parse '{0}'.", value);
// Parse a floating-point value with a currency symbol and a
// thousands separator.
value = "$1,643.57";
if (Single.TryParse(value, out number))
Console.WriteLine(number);
else
Console.WriteLine("Unable to parse '{0}'.", value);
// Parse value in exponential notation.
value = "-1.643e6";
if (Single.TryParse(value, out number))
Console.WriteLine(number);
else
Console.WriteLine("Unable to parse '{0}'.", value);
// Parse a negative integer value.
value = "-168934617882109132";
if (Single.TryParse(value, out number))
Console.WriteLine(number);
else
Console.WriteLine("Unable to parse '{0}'.", value);
// The example displays the following output:
// 1643.57
// Unable to parse '$1,643.57'.
// -164300
// -1.689346E+17
// Parse a floating-point value with a thousands separator.
let value = "1,643.57"
match Single.TryParse value with
| true, number ->
printfn $"{number}"
| _ ->
printfn $"Unable to parse '{value}'."
// Parse a floating-point value with a currency symbol and a
// thousands separator.
let value = "$1,643.57"
match Single.TryParse value with
| true, number ->
printfn $"{number}"
| _ ->
printfn $"Unable to parse '{value}'."
// Parse value in exponential notation.
let value = "-1.643e6"
match Single.TryParse value with
| true, number ->
printfn $"{number}"
| _ ->
printfn $"Unable to parse '{value}'."
// Parse a negative integer value.
let value = "-168934617882109132"
match Single.TryParse value with
| true, number ->
printfn $"{number}"
| _ ->
printfn $"Unable to parse '{value}'."
// The example displays the following output:
// 1643.57
// Unable to parse '$1,643.57'.
// -164300
// -1.689346E+17
Dim value As String
Dim number As Single
' Parse a floating-point value with a thousands separator.
value = "1,643.57"
If Single.TryParse(value, number) Then
Console.WriteLine(number)
Else
Console.WriteLine("Unable to parse '{0}'.", value)
End If
' Parse a floating-point value with a currency symbol and a
' thousands separator.
value = "$1,643.57"
If Single.TryParse(value, number) Then
Console.WriteLine(number)
Else
Console.WriteLine("Unable to parse '{0}'.", value)
End If
' Parse value in exponential notation.
value = "-1.643e6"
If Single.TryParse(value, number)
Console.WriteLine(number)
Else
Console.WriteLine("Unable to parse '{0}'.", value)
End If
' Parse a negative integer number.
value = "-168934617882109132"
If Single.TryParse(value, number)
Console.WriteLine(number)
Else
Console.WriteLine("Unable to parse '{0}'.", value)
End If
' The example displays the following output:
' 1643.57
' Unable to parse '$1,643.57'.
' -1643000
' -1.689346E+17
Hinweise
In .NET Core 3.0 und höher werden werte, die zu groß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.
Diese Überladung unterscheidet sich von der Single.Parse(String)-Methode durch Zurückgeben eines booleschen Werts, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es beseitigt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um eine FormatException zu testen, wenn s
ungültig ist und nicht erfolgreich analysiert werden kann.
Der s
-Parameter kann PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol enthalten (bei dem Zeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet), oder eine Zeichenfolge des Formulars:
[ws] [Zeichen] [Integralziffern,]Integralziffern[.[ Dezimalstellen]][e[Zeichen]exponentielle Ziffern][ws]
Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.
Element | Beschreibung |
---|---|
ws | Eine Reihe von Leerzeichen. |
signieren | Ein negatives Oder positives Zeichensymbol. |
Integralziffern | Eine Reihe numerischer Zeichen zwischen 0 und 9, die den integralen Teil der Zahl angeben. Integralziffern können fehlen, wenn Bruchzahlen vorhanden sind. |
, | Ein kulturspezifisches Gruppentrennzeichen. |
. | Ein kulturspezifisches Dezimalkommasymbol. |
Dezimalstellen | Eine Reihe numerischer Zeichen zwischen 0 und 9, die den Bruchteil der Zahl angeben. |
E- | Ein Groß- oder Kleinbuchstaben "e", das die exponentielle (wissenschaftliche) Schreibweise angibt. |
exponentiellen Ziffern | Eine Reihe numerischer Zeichen zwischen 0 und 9, die einen Exponenten angeben. |
Der s
-Parameter wird mithilfe einer Kombination aus NumberStyles.Float und NumberStyles.AllowThousands Flags interpretiert. Dies bedeutet, dass Leerzeichen und Tausendertrennzeichen zulässig sind, währungssymbole jedoch nicht. Um die Elemente (z. B. Währungssymbole, Tausendertrennzeichen und Leerzeichen) explizit zu definieren, die in s
vorhanden sein können, verwenden Sie die TryParse(String, NumberStyles, IFormatProvider, Single) Methodenüberladung.
Der s
-Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo-Objekt analysiert, das für die aktuelle Systemkultur initialisiert wird. Weitere Informationen finden Sie unter NumberFormatInfo.CurrentInfo. Um eine Zeichenfolge mithilfe der Formatierungsinformationen einer anderen angegebenen Kultur zu analysieren, verwenden Sie die TryParse(String, NumberStyles, IFormatProvider, Single) Methodenüberladung.
Wenn Sie die Single.TryParse Methode übergeben, wird in ordnungsmäßiger Weise eine Zeichenfolge übergeben, die durch Aufrufen der Single.ToString-Methode erstellt wird, der ursprüngliche Single Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich.
Wenn s
außerhalb des Single Datentyps liegt, gibt die Methode false
in .NET Framework und .NET Core 2.2 und früheren Versionen zurück. In .NET Core 3.0 und höheren Versionen wird Single.NegativeInfinity zurückgegeben, wenn s
kleiner als Single.MinValue ist und Single.PositiveInfinity, wenn s
größer als Single.MaxValueist.
Wenn während eines Analysevorgangs ein Trennzeichen im s
-Parameter auftritt und die anwendbaren Währungs- oder Zahlendezimal- und Gruppentrennzeichen identisch sind, wird bei dem Analysevorgang davon ausgegangen, dass es sich bei dem Trennzeichen um ein Dezimaltrennzeichen anstelle eines Gruppentrennzeichens handelt. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.
Weitere Informationen
Gilt für:
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = IUtf8SpanParsable<float>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out float result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * single -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- utf8Text
- ReadOnlySpan<Byte>
Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text
bereitstellt.
- result
- Single
Enthält das Ergebnis der erfolgreichen Analyse utf8Text
oder eines nicht definierten Werts für fehler.
Gibt zurück
true
, wenn utf8Text
erfolgreich analysiert wurde; andernfalls false
.
Gilt für:
TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = ISpanParsable<float>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out float result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- s
- ReadOnlySpan<Char>
Die Spanne der zu analysierenden Zeichen.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse s
oder eines nicht definierten Werts für fehler.
Gibt zurück
true
, wenn s
erfolgreich analysiert wurde; andernfalls false
.
Gilt für:
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- utf8Text
- ReadOnlySpan<Byte>
Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.
- style
- NumberStyles
Eine bitweise Kombination aus Zahlenformatvorlagen, die in utf8Text
vorhanden sein können.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text
bereitstellt.
- result
- Single
Enthält das Ergebnis der erfolgreichen Analyse utf8Text
oder eines nicht definierten Werts für fehler.
Gibt zurück
true
, wenn utf8Text
erfolgreich analysiert wurde; andernfalls false
.
Gilt für:
TryParse(ReadOnlySpan<Byte>, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Versucht, einen UTF-8-Zeichenbereich zu konvertieren, der die Zeichenfolgendarstellung einer Zahl in seine Gleitkommazahlenentsprechung mit einfacher Genauigkeit enthält.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] float % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out float result);
static member TryParse : ReadOnlySpan<byte> * single -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Single) As Boolean
Parameter
- utf8Text
- ReadOnlySpan<Byte>
Eine schreibgeschützte UTF-8-Zeichenspanne, die die zu konvertierende Zahl enthält.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält sie eine Gleitkommazahl mit einer Genauigkeit des numerischen Werts oder Symbols, der in utf8Text
enthalten ist, wenn die Konvertierung erfolgreich war oder null ist, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn die utf8Text
Empty ist oder kein gültiges Format aufweist. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich im Ergebnis angegebenen Werte werden überschrieben.
Gibt zurück
true
, wenn utf8Text
erfolgreich konvertiert wurde; andernfalls false
.
Gilt für:
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Wandelt die Spandarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format in dessen Gleitkommazahlenäquivalent mit einfacher Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result);
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- s
- ReadOnlySpan<Char>
Eine schreibgeschützte Zeichenspanne, die die zu konvertierende Zahl enthält. Die Spanne wird mithilfe der durch style
angegebenen Formatvorlage interpretiert.
- style
- NumberStyles
Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s
angibt. Ein typischer Wert, der angegeben werden soll, ist Float in Kombination mit AllowThousands.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol in s
entspricht, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s
-Parameter null
oder Emptyist, nicht in einem Format enthalten ist, das mit style
kompatibel ist, eine Zahl kleiner als Single.MinValue- oder größer als Single.MaxValue-ist oder wenn style
keine gültige Kombination aus NumberStyles aufgezählten Konstanten ist. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result
angegebenen Werte werden überschrieben.
Gibt zurück
true
, wenn s
erfolgreich konvertiert wurde; andernfalls false
.
Hinweise
In .NET Core 3.0 und höher werden werte, die zu groß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.
Gilt für:
TryParse(String, NumberStyles, IFormatProvider, Single)
- Quelle:
- Single.cs
- Quelle:
- Single.cs
- Quelle:
- Single.cs
Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in dessen Gleitkommazahlenentsprechung mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] float % result) = System::Numerics::INumberBase<float>::TryParse;
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out float result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out float result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * single -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Single) As Boolean
Parameter
- s
- String
Eine Zeichenfolge, die eine zahl darstellt, die konvertiert werden soll.
- style
- NumberStyles
Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s
angibt. Ein typischer Wert, der angegeben werden soll, ist Float in Kombination mit AllowThousands.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
- result
- Single
Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol in s
entspricht, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s
-Parameter null
oder Emptyist, sich nicht in einem Format befindet, das mit style
kompatibel ist, oder wenn style
keine gültige Kombination aus NumberStyles Enumerationskonstanten ist. Es schlägt auch unter .NET Framework oder .NET Core 2.2 und früheren Versionen fehl, wenn s
eine Zahl kleiner als Single.MinValue- oder größer als Single.MaxValue-darstellt. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result
angegebenen Werte werden überschrieben.
Gibt zurück
true
, wenn s
erfolgreich konvertiert wurde; andernfalls false
.
Ausnahmen
Beispiele
Im folgenden Beispiel wird die Verwendung der Single.TryParse(String, NumberStyles, IFormatProvider, Single)-Methode veranschaulicht, um die Zeichenfolgendarstellung von Zahlen zu analysieren, die eine bestimmte Formatvorlage aufweisen und mithilfe der Konventionen einer bestimmten Kultur formatiert sind.
string value;
System.Globalization.NumberStyles style;
System.Globalization.CultureInfo culture;
float number;
// Parse currency value using en-GB culture.
value = "£1,097.63";
style = System.Globalization.NumberStyles.Number |
System.Globalization.NumberStyles.AllowCurrencySymbol;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB");
if (Single.TryParse(value, style, culture, out number))
Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
Console.WriteLine("Unable to convert '{0}'.", value);
value = "1345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR");
if (Single.TryParse(value, style, culture, out number))
Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
Console.WriteLine("Unable to convert '{0}'.", value);
value = "1.345,978";
style = System.Globalization.NumberStyles.AllowDecimalPoint |
System.Globalization.NumberStyles.AllowThousands;
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES");
if (Single.TryParse(value, style, culture, out number))
Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
Console.WriteLine("Unable to convert '{0}'.", value);
value = "1 345,978";
if (Single.TryParse(value, style, culture, out number))
Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
Console.WriteLine("Unable to convert '{0}'.", value);
// The example displays the following output:
// Converted '£1,097.63' to 1097.63.
// Converted '1345,978' to 1345.978.
// Converted '1.345,978' to 1345.978.
// Unable to convert '1 345,978'.
// Parse currency value using en-GB culture.
let value = "£1,097.63"
let style = System.Globalization.NumberStyles.Number ||| System.Globalization.NumberStyles.AllowCurrencySymbol
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "en-GB"
match Single.TryParse(value, style, culture) with
| true, number ->
printfn $"Converted '{value}' to {number}."
| _ ->
printfn $"Unable to convert '{value}'."
let value = "1345,978"
let style = System.Globalization.NumberStyles.AllowDecimalPoint
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "fr-FR"
match Single.TryParse(value, style, culture) with
| true, number ->
printfn $"Converted '{value}' to {number}."
| _ ->
printfn $"Unable to convert '{value}'."
let value = "1.345,978"
let style = System.Globalization.NumberStyles.AllowDecimalPoint ||| System.Globalization.NumberStyles.AllowThousands
let culture = System.Globalization.CultureInfo.CreateSpecificCulture "es-ES"
match Single.TryParse(value, style, culture) with
| true, number ->
printfn $"Converted '{value}' to {number}."
| _ ->
printfn $"Unable to convert '{value}'."
let value = "1 345,978"
match Single.TryParse(value, style, culture) with
| true, number ->
printfn $"Converted '{value}' to {number}."
| _ ->
printfn $"Unable to convert '{value}'."
// The example displays the following output:
// Converted '£1,097.63' to 1097.63.
// Converted '1345,978' to 1345.978.
// Converted '1.345,978' to 1345.978.
// Unable to convert '1 345,978'.
Dim value As String
Dim style As System.Globalization.NumberStyles
Dim culture As System.Globalization.CultureInfo
Dim number As Single
' Parse currency value using en-GB culture.
value = "£1,097.63"
style = System.Globalization.NumberStyles.Number Or _
System.Globalization.NumberStyles.AllowCurrencySymbol
culture = System.Globalization.CultureInfo.CreateSpecificCulture("en-GB")
If Single.TryParse(value, style, culture, number) Then
Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
Console.WriteLine("Unable to convert '{0}'.", value)
End If
value = "1345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint
culture = System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")
If Single.TryParse(value, style, culture, number) Then
Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
Console.WriteLine("Unable to convert '{0}'.", value)
End If
value = "1.345,978"
style = System.Globalization.NumberStyles.AllowDecimalPoint Or _
System.Globalization.NumberStyles.AllowThousands
culture = System.Globalization.CultureInfo.CreateSpecificCulture("es-ES")
If Single.TryParse(value, style, culture, number) Then
Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
Console.WriteLine("Unable to convert '{0}'.", value)
End If
value = "1 345,978"
If Single.TryParse(value, style, culture, number) Then
Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
Console.WriteLine("Unable to convert '{0}'.", value)
End If
' The example displays the following output:
' Converted '£1,097.63' to 1097.63.
' Converted '1345,978' to 1345.978.
' Converted '1.345,978' to 1345.978.
' Unable to convert '1 345,978'.
Hinweise
In .NET Core 3.0 und höher werden werte, die zu groß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.
Diese Überladung unterscheidet sich von der Parse(String, NumberStyles, IFormatProvider)-Methode durch Zurückgeben eines booleschen Werts, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es beseitigt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um eine FormatException zu testen, wenn s
ungültig ist und nicht erfolgreich analysiert werden kann.
Der parameter style
definiert das zulässige Format des s
Parameters, damit der Analysevorgang erfolgreich ausgeführt werden kann. Es muss sich um eine Kombination aus Bitkennzeichnungen aus der NumberStyles Enumeration sein. Die folgenden NumberStyles Mitglieder werden nicht unterstützt:
Der parameter s
kann PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol für die durch provider
angegebene Kultur enthalten. Je nach Wert von style
kann der parameter s
außerdem die folgenden Elemente enthalten:
[ws] [$] [Zeichen] [Integralziffern,]integrale Ziffern[.bruchstellen][e[Zeichen]Exponentielle Ziffern][ws]
Elemente in eckigen Klammern ([ und ]) sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.
Element | Beschreibung |
---|---|
ws | Optionaler Leerraum. Leerzeichen können am Anfang s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite Flag enthält. Sie kann am Ende der s angezeigt werden, wenn style das NumberStyles.AllowTrailingWhite Flag enthält. |
$ | Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die eigenschaften NumberFormatInfo.CurrencyNegativePattern oder NumberFormatInfo.CurrencyPositivePattern des NumberFormatInfo Objekts definiert, das von der IFormatProvider.GetFormat Methode des provider Parameters zurückgegeben wird. Das Währungssymbol kann in s angezeigt werden, wenn style das NumberStyles.AllowCurrencySymbol Flag enthält. |
signieren | Ein optionales Zeichen. Das Zeichen kann am Anfang der s angezeigt werden, wenn style das NumberStyles.AllowLeadingSign Flag enthält, und es kann am Ende s angezeigt werden, wenn style das NumberStyles.AllowTrailingSign Flag enthält. Klammern können in s verwendet werden, um einen negativen Wert anzugeben, wenn style das NumberStyles.AllowParentheses Flag enthält. |
Integralziffern | Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Integralziffern können fehlen, wenn Bruchzahlen vorhanden sind. |
, | Ein kulturspezifisches Tausendertrennzeichen. Das Tausendertrennzeichen der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowThousands Flag enthält. |
. | Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthält. |
Dezimalstellen | Eine Reihe von Ziffern zwischen 0 und 9, die den Bruchteil der Zahl angeben. Dezimalstellen können in s angezeigt werden, wenn style das kennzeichen NumberStyles.AllowDecimalPoint enthält. |
e | Das E- oder E-Zeichen, das angibt, dass s eine Zahl mit exponentieller Schreibweise darstellen kann. Der s -Parameter kann eine Zahl in exponentieller Notation darstellen, wenn die Formatvorlage das NumberStyles.AllowExponent Flag enthält. |
exponentiellen Ziffern | Eine Reihe von Ziffern zwischen 0 und 9, die einen Exponenten angeben. |
Anmerkung
Alle endenden NUL-Zeichen (U+0000) in s
werden unabhängig vom Wert des arguments style
vom Analysevorgang ignoriert.
Eine Zeichenfolge mit Ziffern (die der NumberStyles.None Formatvorlage entspricht) analysiert immer erfolgreich, wenn sie sich im Bereich des Single Typs befindet. Die übrigen System.Globalization.NumberStyles Member-Steuerelementelemente, die möglicherweise vorhanden, aber nicht in der Eingabezeichenfolge vorhanden sein müssen. In der folgenden Tabelle wird angegeben, wie sich einzelne NumberStyles Flags auf die Elemente auswirken, die in s
vorhanden sein können.
NumberStyles-Wert | Elemente, die zusätzlich zu Ziffern in s zulässig sind |
---|---|
None | Nur die Integralziffern Element. |
AllowDecimalPoint | Die . und Bruchzahlen Elemente. |
AllowExponent | Der parameter s kann auch exponentielle Notation verwenden. Diese Kennzeichnung unterstützt selbst Werte in form integralziffernEexponentiellen Ziffern; Zusätzliche Flags werden benötigt, um Zeichenfolgen in exponentieller Notation mit Elementen wie positiven oder negativen Zeichen und Dezimalkommasymbolen erfolgreich zu analysieren. |
AllowLeadingWhite | Das ws-Element am Anfang s . |
AllowTrailingWhite | Das ws-Element am Ende s . |
AllowLeadingSign | Das signieren Element am Anfang s . |
AllowTrailingSign | Das signieren Element am Ende s . |
AllowParentheses | Das Zeichen Element in Form von Klammern, die den numerischen Wert einschließen. |
AllowThousands | Das --Element. |
AllowCurrencySymbol | Das $-Element. |
Currency | Alle. Der parameter s kann keine hexadezimale Zahl oder eine Zahl in exponentieller Schreibweise darstellen. |
Float | Das ws-Element am Anfang oder Ende s , Zeichen am Anfang s , und die .-Symbol. Der parameter s kann auch exponentielle Notation verwenden. |
Number | Das ws -, sign - Tausendertrennzeichen (,), und Dezimalkomma (.) Elemente. |
Any | Alle Formatvorlagen, mit Ausnahme von s , können keine hexadezimale Zahl darstellen. |
Der provider
-Parameter ist eine IFormatProvider Implementierung, deren GetFormat-Methode ein NumberFormatInfo-Objekt zurückgibt, das kulturspezifische Formatierungsinformationen bereitstellt. Wenn die TryParse(String, NumberStyles, IFormatProvider, Single)-Methode aufgerufen wird, ruft sie die GetFormat Methode des provider
Parameters auf und übergibt es ein Type-Objekt, das den NumberFormatInfo Typ darstellt. Die GetFormat-Methode gibt dann das NumberFormatInfo-Objekt zurück, das Informationen zum Format des s
Parameters bereitstellt. Es gibt drei Möglichkeiten, den parameter provider
zum Bereitstellen von benutzerdefinierten Formatierungsinformationen für den Analysevorgang zu verwenden:
Sie können ein CultureInfo-Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen bereitstellt. Die GetFormat-Methode gibt das NumberFormatInfo-Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.
Sie können das tatsächliche NumberFormatInfo-Objekt übergeben, das numerische Formatierungsinformationen bereitstellt. (Seine Umsetzung von GetFormat gibt sich einfach selbst zurück.)
Sie können ein benutzerdefiniertes Objekt übergeben, das IFormatProviderimplementiert. Die GetFormat Methode instanziiert und gibt das NumberFormatInfo-Objekt zurück, das Formatierungsinformationen bereitstellt.
Wenn provider
null
ist, wird die Formatierung s
basierend auf dem NumberFormatInfo Objekt der aktuellen Kultur interpretiert.
Wenn s
außerhalb des Single Datentyps liegt, löst die Methode eine OverflowException in .NET Framework und .NET Core 2.2 und früheren Versionen aus. In .NET Core 3.0 und höheren Versionen wird Single.NegativeInfinity zurückgegeben, wenn s
kleiner als Single.MinValue ist und Single.PositiveInfinity, wenn s
größer als Single.MaxValueist.
Wenn während eines Analysevorgangs ein Trennzeichen im s
-Parameter auftritt und die anwendbaren Währungs- oder Zahlendezimal- und Gruppentrennzeichen identisch sind, wird bei dem Analysevorgang davon ausgegangen, dass es sich bei dem Trennzeichen um ein Dezimaltrennzeichen anstelle eines Gruppentrennzeichens handelt. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.