Single.TryParse Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

Überlädt

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)	Versucht, eine Spanne von Zeichen in einen Wert zu analysieren.
TryParse(ReadOnlySpan<Char>, Single)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einer Zeichenspanne in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.
TryParse(String, Single)	Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)	Versucht, eine Spanne von UTF-8-Zeichen in einen Wert zu analysieren.
TryParse(String, IFormatProvider, Single)	Versucht, eine Zeichenfolge 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, eine UTF-8-Zeichenspanne, die die Zeichenfolgendarstellung einer Zahl enthält, in die entsprechende Gleitkommazahl mit einfacher Genauigkeit zu konvertieren.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)	Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.
TryParse(String, NumberStyles, IFormatProvider, Single)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

Hinweise

In .NET Core 3.0 und höher werden Werte, die für die Darstellung zu groß sind, entsprechend der IEEE 754-Spezifikation auf PositiveInfinity oder NegativeInfinity gerundet. In früheren Versionen, einschließlich .NET Framework, führte die Analyse eines Werts, der für die Darstellung zu groß war, zu Einem Fehler.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

Source:

Single.cs

Versucht, eine Spanne 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ückgibt, enthält das Ergebnis der erfolgreichen sAnalyse oder einen undefinierten Wert bei Einem Fehler.

Gibt zurück

Boolean

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

TryParse(ReadOnlySpan<Char>, Single)

Source:

Single.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einer Zeichenspanne in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

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>

>Eine Zeichenspanne, die die Zeichenfolgendarstellung der zu konvertierenden Zahl enthält.

result

Single

Wenn diese Methode zurückgegeben wird, enthält sie bei erfolgreicher Konvertierung eine Gleitkommazahl mit einfacher Genauigkeit, die dem s-Parameter entspricht, oder „0“ (null), wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s-Parameter null, leer oder keine Zahl im gültigen Format ist. Wenn s eine gültige Zahl kleiner als Single.MinValue ist, result ist NegativeInfinity. Wenn s eine gültige Zahl größer als Single.MaxValue ist, result ist PositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

Boolean

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Hinweise

In .NET Core 3.0 und höher werden Werte, die für die Darstellung zu groß sind, entsprechend der IEEE 754-Spezifikation auf PositiveInfinity oder NegativeInfinity gerundet. In früheren Versionen, einschließlich .NET Framework, führte die Analyse eines Werts, der für die Darstellung zu groß war, zu Einem Fehler.

TryParse(String, Single)

Source:

Single.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::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 die zu konvertierende Zahl darstellt.

result

Single

Diese Methode gibt bei erfolgreicher Konvertierung eine Gleitkommazahl mit einfacher Genauigkeit zurück, die dem numerischen Wert oder dem in s enthaltenen Symbol entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte. Die Konvertierung schlägt fehl, wenn der s-Parameter null, Empty oder keine Zahl im gültigen Format ist. Es tritt auch auf .NET Framework und .NET Core 2.2 und früheren Versionen ein Fehler auf, wenn s eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue darstellt. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

Boolean

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 Werte zu Single 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 für die Darstellung zu groß sind, entsprechend der IEEE 754-Spezifikation auf PositiveInfinity oder NegativeInfinity gerundet. In früheren Versionen, einschließlich .NET Framework, führte die Analyse eines Werts, der für die Darstellung zu groß war, zu Einem Fehler.

Diese Überladung unterscheidet sich von der Single.Parse(String) -Methode, indem sie einen booleschen Wert zurückgibt, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es entfällt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um im Fall eines FormatException zu testen, das s ungültig ist und nicht erfolgreich analysiert werden kann.

Der s Parameter kann , , NegativeInfinitySymbolNaNSymbol (beim Zeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet) oder eine Zeichenfolge im Format enthaltenPositiveInfinitySymbol:

[ws] [sign] [ganzzahlige Ziffern,]ganzzahlige Ziffern[.[ fractional-digits]][e[sign]exponential-digits][ws]

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben.

Element	Beschreibung
ws	Eine Reihe von Leerzeichen.
sign	Ein negatives oder positives Zeichensymbol.
Ganzzahlige Ziffern	Eine Reihe von numerischen Zeichen im Bereich von 0 bis 9, die den integralen Teil der Zahl angeben. Ganzzahlige Ziffern können fehlen, wenn Bruchstellen vorhanden sind.
,	Ein kulturspezifisches Gruppentrennzeichensymbol.
.	Ein kulturspezifisches Dezimaltrennzeichen.
Bruchstellen	Eine Reihe numerischer Zeichen im Bereich von 0 bis 9, die den Bruchteil der Zahl angeben.
E	Ein Groß- oder Kleinbuchstaben "e", das auf exponentielle (wissenschaftliche) Notation hinweist.
exponentielle Ziffern	Eine Reihe von numerischen Zeichen im Bereich von 0 bis 9, die einen Exponenten angeben.

Der s Parameter wird mithilfe einer Kombination aus den NumberStyles.Float Flags und NumberStyles.AllowThousands interpretiert. Dies bedeutet, dass Leerzeichen und Tausendertrennzeichen zulässig sind, Währungssymbole jedoch nicht. Verwenden Sie die -Methodenüberladung, um explizit die Elemente (z. B. Währungssymbole, Tausendertrennzeichen und Leerzeichen) zu definieren, die TryParse(String, NumberStyles, IFormatProvider, Single) in svorhanden sein können.

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 der Single.TryParse Methode normalerweise eine Zeichenfolge übergeben, die durch Aufrufen der Single.ToString -Methode erstellt wird, wird der ursprüngliche Single Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich.

Wenn s sich außerhalb des Bereichs des Single Datentyps befindet, gibt die Methode unter .NET Framework und .NET Core 2.2 und früheren Versionen zurückfalse. Unter .NET Core 3.0 und höheren Versionen wird zurückgegeben Single.NegativeInfinity , wenn s kleiner als Single.MinValue und Single.PositiveInfinity größer s als Single.MaxValueist.

Wenn im s Parameter während eines Analysevorgangs ein Trennzeichen auftritt und die entsprechenden Währungs- oder Zahlendezimal- und Gruppentrennzeichen identisch sind, wird beim Analysevorgang davon ausgegangen, dass das Trennzeichen ein Dezimaltrennzeichen und kein Gruppentrennzeichen ist. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.

Weitere Informationen

• Parse(String)
• ToString()
• Analysieren numerischer Zeichenfolgen in .NET

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

Source:

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 der zu analysierenden UTF-8-Zeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text bereitstellt.

result

Single

Enthält bei rückgabe das Ergebnis der erfolgreichen Analyse oder einen nicht definierten utf8Text Wert bei Einem Fehler.

Gibt zurück

Boolean

true , wenn utf8Text erfolgreich analysiert wurde, falseandernfalls .

TryParse(String, IFormatProvider, Single)

Source:

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ückgibt, enthält das Ergebnis der erfolgreichen s Analyse oder einen nicht definierten Wert bei Einem Fehler.

Gibt zurück

Boolean

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Single)

Source:

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 der zu analysierenden UTF-8-Zeichen.

style

NumberStyles

Eine bitweise Kombination von Zahlenformatvorlagen, die in utf8Textvorhanden sein können.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text bereitstellt.

result

Single

Enthält bei rückgabe das Ergebnis der erfolgreichen Analyse oder einen nicht definierten utf8Text Wert bei Einem Fehler.

Gibt zurück

Boolean

true , wenn utf8Text erfolgreich analysiert wurde, falseandernfalls .

TryParse(ReadOnlySpan<Byte>, Single)

Source:

Single.cs

Versucht, eine UTF-8-Zeichenspanne, die die Zeichenfolgendarstellung einer Zahl enthält, in die entsprechende Gleitkommazahl mit einfacher Genauigkeit zu konvertieren.

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ückgibt, enthält eine Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol entspricht, der in utf8Text enthalten ist, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn das utf8Text in einem gültigen Format vorliegt Empty oder nicht vorliegt. Dieser Parameter wird nicht initialisiert übergeben. Im Ergebnis ursprünglich übergebene Werte werden ausnahmslos überschrieben.

Gibt zurück

Boolean

true, wenn utf8Text erfolgreich konvertiert wurde, andernfalls false.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Single)

Source:

Single.cs

Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

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);

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 unter Verwendung des durch style angegebenen Stils interpretiert.

style

NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt. Ein häufig angegebener Wert ist Float in Kombination mit AllowThousands.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.

result

Single

Diese Methode gibt bei erfolgreicher Konvertierung eine Gleitkommazahl mit einfacher Genauigkeit zurück, die dem numerischen Wert oder dem in s enthaltenen Symbol entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte. Die Konvertierung schlägt fehl, wenn der s Parameter null oder Emptynicht in einem Format ist, das mit stylekonform ist, eine Zahl darstellt, die kleiner als Single.MinValue oder größer als Single.MaxValue ist, oder wenn style keine gültige Kombination von NumberStyles enumerationierten Konstanten ist. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

Boolean

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Hinweise

In .NET Core 3.0 und höher werden Werte, die für die Darstellung zu groß sind, entsprechend der IEEE 754-Spezifikation auf PositiveInfinity oder NegativeInfinity gerundet. In früheren Versionen, einschließlich .NET Framework, führte die Analyse eines Werts, der für die Darstellung zu groß war, zu Einem Fehler.

TryParse(String, NumberStyles, IFormatProvider, Single)

Source:

Single.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

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);

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 die zu konvertierende Zahl darstellt.

style

NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt. Ein häufig angegebener Wert ist Float in Kombination mit AllowThousands.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.

result

Single

Diese Methode gibt bei erfolgreicher Konvertierung eine Gleitkommazahl mit einfacher Genauigkeit zurück, die dem numerischen Wert oder dem in s enthaltenen Symbol entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte. Die Konvertierung kann nicht durchgeführt werden, wenn der s-Parameter null oder Empty ist, kein mit style kompatibles Format aufweist oder style keine gültige Kombination von NumberStyles-Enumerationskonstanten ist. Es tritt auch auf .NET Framework oder .NET Core 2.2 und früheren Versionen ein Fehler auf, wenn s eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue darstellt. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

Boolean

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Ausnahmen

ArgumentException

style ist kein NumberStyles-Wert.

- oder -

style ist der AllowHexSpecifier-Wert.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der Single.TryParse(String, NumberStyles, IFormatProvider, Single) -Methode zum Analysieren der Zeichenfolgendarstellung von Zahlen, die einen bestimmten Stil aufweisen und mit den 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 für die Darstellung zu groß sind, entsprechend der IEEE 754-Spezifikation auf PositiveInfinity oder NegativeInfinity gerundet. In früheren Versionen, einschließlich .NET Framework, führte die Analyse eines Werts, der für die Darstellung zu groß war, zu Einem Fehler.

Diese Überladung unterscheidet sich von der Parse(String, NumberStyles, IFormatProvider) -Methode, indem sie einen booleschen Wert zurückgibt, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es entfällt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um im Fall eines FormatException zu testen, das s ungültig ist und nicht erfolgreich analysiert werden kann.

Der style Parameter definiert das zulässige Format des s Parameters, damit der Analysevorgang erfolgreich ist. Es muss sich um eine Kombination von Bitflags aus der NumberStyles Enumeration handeln. Die folgenden NumberStyles Member werden nicht unterstützt:

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

Der s Parameter kann , NegativeInfinitySymbolfür NaNSymbol die durch providerangegebene Kultur enthaltenPositiveInfinitySymbol. Außerdem kann der s Parameter abhängig vom Wert von styledie folgenden Elemente enthalten:

[ws] [$] [sign] [ganzzahlige Ziffern,]integral-digits[.fractional-digits][e[sign]exponential-digits][ws]

Elemente in eckigen Klammern ([ und ]) sind optional. In der folgenden Tabelle wird jedes Element beschrieben.

Element	Beschreibung
ws	Optionaler Leerraum. Leerzeichen können am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite Flag enthalten ist. Es kann am Ende von s angezeigt werden, wenn style das NumberStyles.AllowTrailingWhite Flag enthält.
$	Ein kulturspezifisches Währungssymbol. Seine Position in der Zeichenfolge wird durch die NumberFormatInfo.CurrencyNegativePattern Eigenschaften oder NumberFormatInfo.CurrencyPositivePattern des Objekts definiert, das NumberFormatInfo 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.
sign	Ein optionales Zeichen. Das Zeichen kann am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingSign Flag enthält, und es kann am Ende von 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 enthalten ist.
Ganzzahlige Ziffern	Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Ganzzahlige Ziffern können fehlen, wenn Bruchstellen 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 Dezimaltrennzeichen. Das Dezimalzeichensymbol der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthält.
Bruchstellen	Eine Reihe von Ziffern im Bereich von 0 bis 9, die den Bruchteil der Zahl angeben. Teilziffern können in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthalten ist.
e	Das Zeichen e oder E, das angibt, dass s eine Zahl mit exponentieller Notation darstellen kann. Der s Parameter kann eine Zahl in exponentieller Notation darstellen, wenn style das NumberStyles.AllowExponent Flag enthält.
exponentielle Ziffern	Eine Reihe von Ziffern im Bereich von 0 bis 9, die einen Exponenten angeben.

Hinweis

Alle endenden NUL-Zeichen (U+0000) in s werden vom Analysevorgang ignoriert, unabhängig vom Wert des style Arguments.

Eine Zeichenfolge nur mit Ziffern (die der NumberStyles.None Formatvorlage entspricht) analysiert immer erfolgreich, wenn sie sich im Bereich des Single Typs befindet. Die verbleibenden System.Globalization.NumberStyles Member steuern Elemente, die möglicherweise in der Eingabezeichenfolge vorhanden sein müssen, aber nicht erforderlich sind. In der folgenden Tabelle wird angegeben, wie sich einzelne NumberStyles Flags auf die Elemente auswirken, die in svorhanden sein können.

NumberStyles-Wert	Zulässige Elemente in s zusätzlich zu Ziffern
None	Nur das Integral-Digits-Element .
AllowDecimalPoint	Die Elemente . und Bruchstellen .
AllowExponent	Der s Parameter kann auch exponentielle Notation verwenden. Dieses Flag selbst unterstützt Werte in der Form integrale ZiffernEexponentielle Ziffern; Zusätzliche Flags sind erforderlich, um Zeichenfolgen in exponentieller Notation erfolgreich mit Elementen wie positiven oder negativen Zeichen und Dezimalzeichen zu analysieren.
AllowLeadingWhite	Das ws-Element am Anfang von s.
AllowTrailingWhite	Das ws-Element am Ende von s.
AllowLeadingSign	Das Zeichenelement am Anfang von s.
AllowTrailingSign	Das Zeichenelement am Ende von s.
AllowParentheses	Das Zeichenelement in Form von Klammern, die den numerischen Wert einschließen.
AllowThousands	Das -Element.
AllowCurrencySymbol	Das $-Element.
Currency	Alle. Der s Parameter kann keine hexadezimale Zahl oder eine Zahl in exponentieller Notation darstellen.
Float	Das ws-Element am Anfang oder Ende von s, signieren am Anfang von sund das Symbol . Der s Parameter kann auch exponentielle Notation verwenden.
Number	Die wsElemente , , signTausendertrennzeichen (,) und Dezimaltrennzeichen (.).
Any	Alle Stile, außer s können keine Hexadezimalzahl 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 provider -Methode des GetFormat Parameters auf und übergibt ihr 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 provider Parameter zu verwenden, um benutzerdefinierte Formatierungsinformationen für den Analysevorgang anzugeben:

• 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 Implementierung von GetFormat gibt sich einfach selbst zurück.)

• Sie können ein benutzerdefiniertes IFormatProviderObjekt übergeben, das implementiert. Die - GetFormat Methode instanziiert und gibt das NumberFormatInfo -Objekt zurück, das Formatierungsinformationen bereitstellt.

Wenn provider ist null, wird die Formatierung von s basierend auf dem NumberFormatInfo -Objekt der aktuellen Kultur interpretiert.

Wenn s sich außerhalb des Bereichs des Single Datentyps befindet, löst die -Methode unter .NET Framework und .NET Core 2.2 und früheren Versionen eine ausOverflowException. Unter .NET Core 3.0 und höheren Versionen wird zurückgegeben Single.NegativeInfinity , wenn s kleiner als Single.MinValue und Single.PositiveInfinity größer s als Single.MaxValueist.

Wenn im s Parameter während eines Analysevorgangs ein Trennzeichen auftritt und die entsprechenden Währungs- oder Zahlendezimal- und Gruppentrennzeichen identisch sind, wird beim Analysevorgang davon ausgegangen, dass das Trennzeichen ein Dezimaltrennzeichen und kein Gruppentrennzeichen ist. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparatorund NumberGroupSeparator.

Weitere Informationen

• Parse(String)
• ToString()
• Analysieren numerischer Zeichenfolgen in .NET