Single.TryParse Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

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

Name	Beschreibung
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ß sind, um sie darzustellen, auf PositiveInfinity die IEEE 754-Spezifikation gerundet oder NegativeInfinity entsprechend der IEEE 754-Spezifikation. 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

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.

result

Single

Wenn diese Methode zurückgegeben wird, enthält das Ergebnis einer erfolgreichen Analyse oder eines nicht definierten Werts s für fehler.

Gibt zurück

Boolean

truewenn s erfolgreich analysiert wurde; andernfalls . false

TryParse(ReadOnlySpan<Char>, Single)

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 s Parameter leer ist null oder keine Zahl in einem gültigen Format ist. Ist s eine gültige Zahl kleiner als Single.MinValue, result ist NegativeInfinity. Ist s eine gültige Zahl größer als Single.MaxValue, result ist PositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich bereitgestellten result Werte werden überschrieben.

Gibt zurück

Boolean

true wenn s erfolgreich konvertiert wurde; andernfalls false.

Hinweise

In .NET Core 3.0 und höher werden werte, die zu groß sind, um sie darzustellen, auf PositiveInfinity die IEEE 754-Spezifikation gerundet oder NegativeInfinity entsprechend der IEEE 754-Spezifikation. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.

TryParse(String, Single)

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

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, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s Parameter eine Zahl in einem gültigen Format ist null oder Empty nicht. Es schlägt auch bei .NET Framework fehl, wenn s eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue ist. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich bereitgestellten result Werte werden überschrieben.

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 zu groß sind, um sie darzustellen, auf PositiveInfinity die IEEE 754-Spezifikation gerundet oder NegativeInfinity entsprechend der IEEE 754-Spezifikation. 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 für ein FormatException ungültiges Ereignis s zu testen und kann nicht erfolgreich analysiert werden.

Der s Parameter kann Ein- NegativeInfinitySymboloder NaNSymbol Symbol enthaltenPositiveInfinitySymbol. Bei diesem Zeichenfolgenvergleich wird die Groß-/Kleinschreibung in .NET Core 3.0 und höheren Versionen beachtet, bei früheren Versionen, einschließlich .NET Framework, wird die Groß-/Kleinschreibung jedoch beachtet. Der s Parameter kann auch eine Zeichenfolge des Formulars sein:

[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.
Zeichen	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.
Bruchzahlen	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.
Exponentielle Ziffern	Eine Reihe numerischer Zeichen zwischen 0 und 9, die einen Exponenten angeben.

Der s Parameter wird mithilfe einer Kombination aus den Flags und NumberStyles.Float den 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 vorhanden ssein 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. Verwenden Sie die TryParse(String, NumberStyles, IFormatProvider, Single) Methodenüberladung, um eine Zeichenfolge mithilfe der Formatierungsinformationen einer anderen angegebenen Kultur zu analysieren.

Wenn Sie die Single.TryParse Methode über 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 der Datentyp außerhalb des Single Bereichs liegt, gibt die Methode für .NET Framework zurück false . In .NET Core 3.0 und höheren Versionen wird zurückgegeben Single.NegativeInfinity , wenn s sie kleiner als Single.MinValue 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

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

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Single)

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.

result

Single

Enthält das Ergebnis einer erfolgreichen Analyse oder eines nicht definierten Werts utf8Text für fehler.

Gibt zurück

Boolean

truewenn utf8Text erfolgreich analysiert wurde; andernfalls . false

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

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.

result

Single

Wenn diese Methode zurückgegeben wird, enthält das Ergebnis der erfolgreichen Analyse oder eines nicht definierten Werts sfür fehler.

Gibt zurück

Boolean

truewenn s erfolgreich analysiert wurde; andernfalls . false

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

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 vorhanden utf8Textsein können.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text.

result

Single

Enthält das Ergebnis einer erfolgreichen Analyse oder eines nicht definierten Werts utf8Text für fehler.

Gibt zurück

Boolean

truewenn utf8Text erfolgreich analysiert wurde; andernfalls . false

TryParse(ReadOnlySpan<Byte>, Single)

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 enthalten utf8Text ist, wenn die Konvertierung erfolgreich war oder null ist, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn dies utf8TextEmpty in einem gültigen Format vorliegt oder nicht. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich im Ergebnis angegebenen Werte werden überschrieben.

Gibt zurück

Boolean

true wenn utf8Text erfolgreich konvertiert wurde; andernfalls false.

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

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) = 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 mithilfe der formatierten styleFormatvorlage interpretiert.

style

NumberStyles

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

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s.

result

Single

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol entspricht, der bzw. das in s, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s Parameter nicht in einem Format enthalten ist, Emptydas mit styledem Format kompatibel istnull, stellt eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue dar, oder wenn style es sich nicht um eine gültige Kombination aus NumberStyles aufgezählten Konstanten handelt. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich bereitgestellten result Werte werden überschrieben.

Gibt zurück

Boolean

true wenn s erfolgreich konvertiert wurde; andernfalls false.

Hinweise

In .NET Core 3.0 und höher werden werte, die zu groß sind, um sie darzustellen, auf PositiveInfinity die IEEE 754-Spezifikation gerundet oder NegativeInfinity entsprechend der IEEE 754-Spezifikation. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.

TryParse(String, NumberStyles, IFormatProvider, Single)

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) = 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 eine zahl darstellt, die konvertiert werden soll.

style

NumberStyles

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

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s.

result

Single

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit einfacher Genauigkeit, die dem numerischen Wert oder Symbol entspricht, der bzw. das in s, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s Parameter nullEmptynicht in einem formatkonform styleist oder keine style gültige Kombination von NumberStyles Enumerationskonstanten ist. Es schlägt auch bei .NET Framework fehl, wenn s eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue ist. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich bereitgestellten result Werte werden überschrieben.

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

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

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ß sind, um sie darzustellen, auf PositiveInfinity die IEEE 754-Spezifikation gerundet oder NegativeInfinity entsprechend der IEEE 754-Spezifikation. 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 für ein FormatException ungültiges Ereignis s zu testen und kann nicht erfolgreich analysiert werden.

Der style Parameter definiert das zulässige Format des s Parameters, damit der Analysevorgang erfolgreich ausgeführt werden kann. Es muss eine Kombination aus Bitkennzeichnungen aus der NumberStyles Enumeration sein. Die folgenden NumberStyles Member werden nicht unterstützt:

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

Der s Parameter kann , NegativeInfinitySymboloder NaNSymbol Symbol für die Kultur enthaltenPositiveInfinitySymbol, die durch provider. Bei diesem Zeichenfolgenvergleich wird die Groß-/Kleinschreibung in .NET Core 3.0 und höheren Versionen beachtet, bei früheren Versionen, einschließlich .NET Framework, wird die Groß-/Kleinschreibung jedoch beachtet. Je nach Wert kann styleder s Parameter 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 angezeigt s werden, wenn style die NumberStyles.AllowLeadingWhite Kennzeichnung enthalten ist. Sie kann am Ende der s Kennzeichnung angezeigt werden, wenn style sie die NumberStyles.AllowTrailingWhite Kennzeichnung enthält.
$	Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die oder NumberFormatInfo.CurrencyPositivePattern die NumberFormatInfo.CurrencyNegativePattern Eigenschaften des Objekts definiert, das NumberFormatInfo von der IFormatProvider.GetFormat Methode des provider Parameters zurückgegeben wird. Das Währungssymbol kann angezeigt werden, wenn s das style Kennzeichen enthalten NumberStyles.AllowCurrencySymbol ist.
Zeichen	Ein optionales Zeichen. Das Zeichen kann am Anfang des s Zeichens angezeigt werden, wenn style das NumberStyles.AllowLeadingSign Kennzeichen enthalten ist, und es kann am Ende s angezeigt werden, wenn style das NumberStyles.AllowTrailingSign Kennzeichen enthalten ist. Klammern können verwendet s werden, um einen negativen Wert anzugeben, wenn style das NumberStyles.AllowParentheses Flag enthalten ist.
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 angezeigt werden s , wenn style die NumberStyles.AllowThousands Kennzeichnung enthalten ist.
.	Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der aktuellen Kultur kann angezeigt werden s , wenn style das NumberStyles.AllowDecimalPoint Kennzeichen enthalten ist.
Bruchzahlen	Eine Reihe von Ziffern zwischen 0 und 9, die den Bruchteil der Zahl angeben. Dezimalstellen können angezeigt s werden, wenn style die NumberStyles.AllowDecimalPoint Kennzeichnung enthalten ist.
e	Das E- oder E-Zeichen, das angibt, dass s eine Zahl mit exponentieller Schreibweise dargestellt werden kann. Der s Parameter kann eine Zahl in exponentieller Notation darstellen, wenn die Formatvorlage das NumberStyles.AllowExponent Flag enthält.
Exponentielle Ziffern	Eine Reihe von Ziffern zwischen 0 und 9, die einen Exponenten angeben.

Anmerkung

Alle endenden NUL-Zeichen s (U+0000) werden unabhängig vom Wert des style Arguments 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 Elemente steuern Elemente, 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 möglicherweise svorhanden sind.

NumberStyles-Wert	Elemente, die zusätzlich zu Ziffern in s zulässig sind
None	Nur das Integralziffernelement .
AllowDecimalPoint	Die Elemente " . " und "Bruchzahlen" .
AllowExponent	Der s Parameter kann auch exponentielle Notation verwenden. Diese Kennzeichnung unterstützt selbst Werte in der Form integraler ZiffernEexponentielle 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 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 Schreibweise darstellen.
Float	Das ws-Element am Anfang oder Ende von s, Zeichen am Anfang von s, und das Symbol . Der s Parameter kann auch exponentielle Notation verwenden.
Number	Die wsElemente , , signTausendertrennzeichen (,) und Dezimalkomma (.).
Any	Alle Formatvorlagen, mit Ausnahme s einer hexadezimalen Zahl.

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 Methode des providerGetFormat 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 provider Parameter 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 GetFormat von nur zurückgibt.)

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

Ist provider dies nullder Grund, wird die Formatierung s basierend auf dem NumberFormatInfo Objekt der aktuellen Kultur interpretiert.

Wenn s der Datentyp außerhalb des Single Zulässigen liegt, löst die Methode ein OverflowException .NET Framework aus. In .NET Core 3.0 und höheren Versionen wird zurückgegeben Single.NegativeInfinity , wenn s sie kleiner als Single.MinValue 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

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