Single.TryParse Methode

Definition

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, einen Bereich von Zeichen in einen Wert zu analysieren.

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<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, IFormatProvider, Single)
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.

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.

Hinweise

In .NET Core 3.0 und höher werden werte, die zu groß sind, um dargestellt zu werden, NegativeInfinity oder wie dies von der IEEE 754-Spezifikation erforderlich istPositiveInfinity. In früheren Versionen, einschließlich .NET Framework, analysiert ein Wert, der zu groß war, um einen Fehler darzustellen.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Single)

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

provider
IFormatProvider
result
Single

Gibt zurück

Boolean

true wenn s erfolgreich analysiert wurde; andernfalls false.

Gilt für:

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.

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 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 schlägt auch bei .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.MaxValue 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 zu groß sind, um dargestellt zu werden, NegativeInfinity oder wie dies von der IEEE 754-Spezifikation erforderlich istPositiveInfinity. In früheren Versionen, einschließlich .NET Framework, analysiert ein Wert, der zu groß war, um einen Fehler darzustellen.

Diese Überladung unterscheidet sich von der Single.Parse(String) Methode, indem ein boolescher Wert zurückgegeben wird, der angibt, ob der Parsevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es entfernt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um eine in dem Ereignis zu testen FormatException , das s ungültig ist und nicht erfolgreich analysiert werden kann.

Der s Parameter kann , , ( NaNSymbol NegativeInfinitySymbolder Zeichenfolgenvergleich ist Groß-/Kleinschreibung) oder eine Zeichenfolge des Formulars enthaltenPositiveInfinitySymbol:

[ws] [sign] [integrale Ziffern;]integrale Ziffern[.[ Bruchstellen]][e[Sign]exponentielle Ziffern][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 Zeichen oder positives Zeichensymbol.
integrale Ziffern Eine Reihe numerischer Zeichen von 0 bis 9, die den integralen Teil der Zahl angeben. Integrale Ziffern können nicht vorhanden sein, wenn bruchstellende Ziffern vorhanden sind.
, Ein kulturspezifisches Gruppentrennzeichen.
. Ein kulturspezifisches Dezimalzeichen.
Bruchstellen Eine Reihe numerischer Zeichen von 0 bis 9, die den Bruchteil der Zahl angeben.
E Ein Groß- oder Kleinbuchstabenzeichen 'e', das exponentielle (wissenschaftliche) Notation angibt.
exponentielle Ziffern Eine Reihe numerischer Zeichen von 0 bis 9, die einen Exponent angeben.

Der s Parameter wird mithilfe einer Kombination aus den NumberStyles.Float NumberStyles.AllowThousands und den Flags interpretiert. Dies bedeutet, dass Leerzeichen und Tausende Trennzeichen zulässig sind, aber Währungssymbole 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. Um eine Zeichenfolge mithilfe der Formatierungsinformationen einiger anderer angegebenen Kultur zu analysieren, verwenden Sie die TryParse(String, NumberStyles, IFormatProvider, Single) Methodenüberladung.

Ordinarily, wenn Sie die Methode übergeben, eine Zeichenfolge, die durch Aufrufen der Single.TryParse Single.ToString Methode erstellt wird, wird der ursprüngliche Single Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts können die Werte jedoch möglicherweise nicht gleich sein.

Wenn s der Datentyp nicht vorhanden Single ist, gibt false die Methode .NET Framework und .NET Core 2.2 und frühere Versionen zurück. Bei .NET Core 3.0 und späteren Versionen gibt Single.NegativeInfinity sie zurück, wenn es kleiner Single.MinValue als ist und s Single.PositiveInfinity wenn s größer als Single.MaxValueist.

Wenn während eines Analysevorgangs ein Trennzeichen im s Parameter aufgetreten ist, und die anwendbare Währung oder die Dezimal- und Gruppentrennzeichen sind identisch, wird davon ausgegangen, dass das Trennzeichen ein Dezimaltrennzeichen ist, anstatt ein Gruppentrennzeichen. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparatorCurrencyGroupSeparatorund NumberGroupSeparator.

Siehe auch

Gilt für:

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.

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. 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. 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 zu groß sind, um dargestellt zu werden, NegativeInfinity oder wie dies von der IEEE 754-Spezifikation erforderlich istPositiveInfinity. In früheren Versionen, einschließlich .NET Framework, analysiert ein Wert, der zu groß war, um einen Fehler darzustellen.

Gilt für:

TryParse(String, IFormatProvider, Single)

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
provider
IFormatProvider
result
Single

Gibt zurück

Boolean

Gilt für:

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.

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::INumber<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 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 schlägt auch bei .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. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

Boolean

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 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, gerundet PositiveInfinity oder NegativeInfinity gemäß der IEEE 754-Spezifikation. In früheren Versionen, einschließlich .NET Framework, wurde ein Wert analysiert, der zu groß war, um einen Fehler darzustellen.

Diese Überladung unterscheidet sich von der Parse(String, NumberStyles, IFormatProvider) Methode, indem ein boolescher Wert zurückgegeben wird, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es beseitigt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um zu testen, s ob ein FormatException Ereignis ungültig ist und nicht erfolgreich analysiert werden kann.

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

Der s Parameter kann , NegativeInfinitySymbolNaNSymbol für die von providerder Kultur angegebene Kultur enthaltenPositiveInfinitySymbol. Darüber hinaus kann der Parameter je nach Wert styledie s folgenden Elemente enthalten:

[ws] [$] [Sign] [integrale Ziffern;]integrale Ziffern[.bruchstellen][e[sign]exponentielle Ziffern][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 s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite Kennzeichen enthalten ist. Sie kann am Ende s angezeigt werden, wenn style das NumberStyles.AllowTrailingWhite Kennzeichen enthalten ist.
$ Ein kulturspezifisches Währungssymbol. Seine Position in der Zeichenfolge wird durch die oder NumberFormatInfo.CurrencyPositivePattern die NumberFormatInfo.CurrencyNegativePattern Eigenschaften des NumberFormatInfo Objekts definiert, das von der IFormatProvider.GetFormat Methode des provider Parameters zurückgegeben wird. Das Währungssymbol kann angezeigt werden s , wenn style das NumberStyles.AllowCurrencySymbol Kennzeichen enthalten ist.
sign Ein optionales Zeichen. Das Zeichen kann am Anfang s 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 Kennzeichen enthalten ist.
integrale Ziffern Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Integrale Ziffern können nicht vorhanden sein, wenn Bruchstellen vorhanden sind.
, Ein kulturspezifisches Tausendertrennzeichensymbol. Das Tausendertrennzeichen der aktuellen Kultur kann angezeigt werden, wenn style das NumberStyles.AllowThousands Kennzeichen enthalten s ist.
. Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der aktuellen Kultur kann angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Kennzeichen enthalten s ist.
Bruchstellen Eine Reihe von Ziffern zwischen 0 und 9, die den Bruchteil der Zahl angeben. Bruchstellen können angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Kennzeichen enthalten s ist.
e Das E- oder E-Zeichen, das angibt, dass s eine Zahl mit exponentieller Notation 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.

Hinweis

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

Eine Zeichenfolge mit Ziffern (die der NumberStyles.None Formatvorlage entsprechen) analysiert immer erfolgreich, wenn sie sich im Bereich des Single Typs befindet. Die verbleibenden System.Globalization.NumberStyles Elemente steuern Elemente, die möglicherweise vorhanden sind, 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 vorhanden ssind.

NumberStyles-Wert Elemente, die zusätzlich zu Ziffern in s zulässig sind
None Das Element "integrale Ziffern " wird nur verwendet.
AllowDecimalPoint Das Sprachelement . und Bruchstellenelemente .
AllowExponent Der s Parameter kann auch exponentielle Notation verwenden. Dieses Kennzeichen unterstützt selbst Werte in der Form integraler Ziffern E exponentielle Ziffern; Zusätzliche Flags sind erforderlich, um Zeichenfolgen erfolgreich in exponentielle Notation mit Elementen wie positiven oder negativen Zeichen und Dezimalkommasymbolen 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 Sign-Element am Ende von s.
AllowParentheses Das Sign-Element in Form von Klammern, die den numerischen Wert einschließen.
AllowThousands Das , Element.
AllowCurrencySymbol Das $ Element.
Currency Alle. Der s Parameter kann keine Hexadezimalzahl oder eine Zahl in exponentieller Notation darstellen.
Float Das ws-Element am Anfang oder Ende von s, Zeichen am Anfang von s, und der . aus. Der s Parameter kann auch exponentielle Notation verwenden.
Number Die wsElemente , , signTausendertrennzeichen (,) und Dezimalstellen (.)
Any Alle Formatvorlagen, mit Ausnahme s einer Hexadezimalzahl, können nicht dargestellt werden.

Der provider Parameter ist eine IFormatProvider Implementierung, deren Methode ein NumberFormatInfo Objekt zurückgibt, GetFormat das kulturspezifische Formatierungsinformationen bereitstellt. Wenn die TryParse(String, NumberStyles, IFormatProvider, Single) Methode aufgerufen wird, ruft sie die Methode des provider Parameters GetFormat 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 Implementierung GetFormat von just returns selbst.)

  • 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 dies der Grundprovider, wird die Formatierung s basierend auf dem NumberFormatInfo Objekt der aktuellen Kultur nullinterpretiert.

Wenn s der Single Datentyp außerhalb des Datentyps liegt, löst die Methode eine OverflowException .NET Framework und .NET Core 2.2 und frühere Versionen aus. In .NET Core 3.0- und höher-Versionen gibt Single.NegativeInfinity sie zurück, wenn s es kleiner als Single.MinValue und Single.PositiveInfinity wenn s größer als Single.MaxValueist.

Wenn ein Trennzeichen während eines Analysevorgangs im s Parameter auftritt, und die anwendbaren Währungs- oder Zahlendezimal- und Gruppentrennzeichen identisch sind, geht der Analysevorgang davon aus, dass es sich bei dem Trennzeichen um ein Dezimaltrennzeichen anstelle eines Gruppentrennzeichens handelt. Weitere Informationen zu Trennzeichen finden Sie unter CurrencyDecimalSeparator, NumberDecimalSeparator, CurrencyGroupSeparator, und NumberGroupSeparator.

Siehe auch

Gilt für:

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.

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::INumber<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 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 Emptynicht in einem Format entspricht, das mit einem Format kompatibel styleist, eine Zahl kleiner als Single.MinValue oder größer als Single.MaxValue oder wenn style keine gültige Kombination von NumberStyles aufgezählten Konstanten ist.MinValue 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 zu groß sind, um dargestellt zu werden, NegativeInfinity oder wie dies von der IEEE 754-Spezifikation erforderlich istPositiveInfinity. In früheren Versionen, einschließlich .NET Framework, wurde ein Wert analysiert, der zu groß war, um einen Fehler darzustellen.

Gilt für: