Teilen über


Single.TryParse Methode

Definition

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 sbereitstellt.

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 snull oder leer ist oder keine Zahl in einem gültigen Format ist. Wenn s eine gültige Zahl kleiner als Single.MinValue-ist, ist resultNegativeInfinity. Wenn s eine gültige Zahl größer als Single.MaxValue-ist, ist resultPositiveInfinity. 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 senthalten ist, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter snull 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 svorhanden 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 utf8Textbereitstellt.

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 sbereitstellt.

result
Single

Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse soder 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 utf8Textvorhanden sein können.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Textbereitstellt.

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 utf8TextEmpty 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 styleangegebenen Formatvorlage interpretiert.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von sangibt. Ein typischer Wert, der angegeben werden soll, ist Float in Kombination mit AllowThousands.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result
Single

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol in sentspricht, 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 stylekompatibel 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 sangibt. Ein typischer Wert, der angegeben werden soll, ist Float in Kombination mit AllowThousands.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result
Single

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol in sentspricht, 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 stylekompatibel 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

style ist kein NumberStyles Wert.

-oder-

style ist der AllowHexSpecifier Wert.

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 providerangegebene Kultur enthalten. Je nach Wert von stylekann 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 svorhanden 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 providernullist, 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.

Weitere Informationen

Gilt für: