nfloat.Parse Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
Parse(String) |
Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende Gleitkommazahl mit doppelter Genauigkeit. |
Parse(String, NumberStyles) | |
Parse(String, IFormatProvider) |
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem bestimmten kulturspezifischen Format in die entsprechende Gleitkommazahl mit doppelter Genauigkeit. |
Parse(String, NumberStyles, IFormatProvider) |
Parse(String)
Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende Gleitkommazahl mit doppelter Genauigkeit.
public static nfloat Parse (string s);
static member Parse : string -> nfloat
Parameter
- s
- String
Eine Zeichenfolge, die eine zu konvertierende Zahl enthält.
Gibt zurück
Eine nfloat-Gleitkommazahl, die dem in s
angegebenen numerischen Wert oder Symbol entspricht.
Hinweise
Der s
Parameter kann die P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol, P:System.Globalization.NumberFormatInfo.NaNSymbol enthalten, oder eine Zeichenfolge des Formulars:
[ws] [sign] [Integralziffern[,]]integral-digits[.[ Bruchstellen]][E[Zeichen]exponentielle Ziffern][ws]
Elemente in eckigen Klammern ([ und ]) sind optional. In der folgenden Tabelle wird jedes Element beschrieben.
Element | BESCHREIBUNG |
---|---|
ws | Eine Reihe von Leerzeichen. |
Signieren | Ein negatives Zeichensymbol (-) oder ein positives Zeichensymbol (+). Es kann nur ein führendes Zeichen verwendet werden. |
Ganzzahlige Ziffern | Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Ausführungen von ganzzahligen Ziffern können durch ein Gruppentrennzeichensymbol partitioniert werden. In einigen Kulturen trennt z. B. ein Komma (,) Gruppen von Tausenden. Das integral-digits-Element kann nicht vorhanden sein, wenn die Zeichenfolge das Element "Fractional Digits" enthält. |
, | Ein kulturspezifisches Tausendertrennzeichen. |
. | Ein kulturspezifisches Dezimaltrennzeichen. |
Bruchstellen | Eine Reihe von Ziffern im Bereich von 0 bis 9, die den Bruchteil der Zahl angeben. |
E | Das Zeichen "e" oder "E", das angibt, dass der Wert in exponentieller (wissenschaftlicher) Notation dargestellt wird. |
exponentielle Ziffern | Eine Reihe von Ziffern im Bereich von 0 bis 9, die einen Exponenten angeben. |
Der s
Parameter wird mithilfe einer Kombination der F:System.Globalization.NumberStyles.Float - und F:System.Globalization.NumberStyles.AllowThousands-Flags interpretiert. Dies bedeutet, dass Leerzeichen und Tausendertrennzeichen beispielsweise zulässig sind, während Währungssymbole dies nicht sind. Um genauer zu steuern, welche Stilelemente in s
zulässig sind, damit der Analysevorgang erfolgreich ist, rufen M:System.Double.Parse(System.String,System.Globalization.NumberStyles) oder M:System.Double.Parse(System.String,System.Globalization.NumberStyles, System.IFormatProvider) -Methode.
Der s
Parameter wird mithilfe der Formatierungsinformationen in einem System.Globalization.NumberFormatInfo-Objekt interpretiert, das für die aktuelle Threadkultur initialisiert wird. Weitere Informationen finden Sie unter P:System.Globalization.NumberFormatInfo.CurrentInfo. Um eine Zeichenfolge mithilfe der Formatierungsinformationen einer anderen Kultur zu analysieren, rufen Sie die M:System.Double.Parse(System.String,System.IFormatProvider) or M:System.Double.Parse(System.String,System.Globalization.NumberStyles,System.IFormatProvider)- Methode auf.
Wenn Sie die -Methode übergeben, wird normalerweise eine Zeichenfolge übergeben, die durch Aufrufen der -Methode erstellt wird, der ursprüngliche :System.Double.Double*-Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus wird beim Versuch, die Zeichenfolgendarstellung von F:System.Double.MinValue oder System.Double.MaxValue zu analysieren, eine System.OverflowException ausgelöst, wie im folgenden Beispiel veranschaulicht.
Codereferenz: System.Double.Parse#3
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 P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator und P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Gilt für:
Parse(String, NumberStyles)
public static nfloat Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> nfloat
Parameter
- s
- String
- style
- NumberStyles
Gibt zurück
Gilt für:
Parse(String, IFormatProvider)
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem bestimmten kulturspezifischen Format in die entsprechende Gleitkommazahl mit doppelter Genauigkeit.
public static nfloat Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> nfloat
Parameter
- s
- String
Eine Zeichenfolge, die eine zu konvertierende Zahl enthält.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
Gibt zurück
Eine nfloat-Gleitkommazahl, die dem in s
angegebenen numerischen Wert oder Symbol entspricht.
Hinweise
Diese Überladung der -Methode wird in der Parse(String, IFormatProvider) Regel verwendet, um Text, der auf verschiedene Arten formatiert werden kann, in einen nfloat Wert zu konvertieren. Sie kann beispielsweise verwendet werden, um den von einem Benutzer eingegebenen Text in ein HTML-Textfeld in einen numerischen Wert zu konvertieren.
Der s
Parameter wird mithilfe einer Kombination der F:System.Globalization.NumberStyles.Float - und F:System.Globalization.NumberStyles.AllowThousands-Flags interpretiert. Der s
Parameter kann P:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol, P:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol oder P:System.Globalization.NumberFormatInfo.NaNSymbol für die Kultur enthalten. angegeben durch provider
, oder es kann eine Zeichenfolge in der Form enthalten:
[ws] [sign]integral-digits[.[ Bruchstellen]][E[Zeichen]exponentielle Ziffern][ws]
Optionale Elemente werden in eckigen Klammern ([ und ]) eingerahmt. Elemente, die den Begriff "Ziffern" enthalten, bestehen aus einer Reihe numerischer Zeichen im Bereich von 0 bis 9.
Element | BESCHREIBUNG |
---|---|
ws | Eine Reihe von Leerzeichen. |
Signieren | Ein negatives Zeichensymbol (-) oder ein positives Zeichensymbol (+). |
Ganzzahlige Ziffern | Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Ausführungen von ganzzahligen Ziffern können durch ein Gruppentrennzeichensymbol partitioniert werden. In einigen Kulturen trennt z. B. ein Komma (,) Gruppen von Tausenden. Das integral-digits-Element kann nicht vorhanden sein, wenn die Zeichenfolge das Element "Fractional Digits" enthält. |
. | Ein kulturspezifisches Dezimaltrennzeichen. |
Bruchstellen | Eine Reihe von Ziffern im Bereich von 0 bis 9, die den Bruchteil der Zahl angeben. |
E | Das Zeichen "e" oder "E", das angibt, dass der Wert in exponentieller (wissenschaftlicher) Notation dargestellt wird. |
exponentielle Ziffern | Eine Reihe von Ziffern im Bereich von 0 bis 9, die einen Exponenten angeben. |
Der provider
Parameter ist eine T:System.IFormatProvider-Implementierung , deren M:System.IFormatProvider.GetFormat(System.Type) -Methode ein System.Globalization.NumberFormatInfo-Objekt zurückgibt, das kulturspezifische Informationen bereitstellt, die bei der Interpretation des Formats von s
verwendet werden. In der Regel handelt es sich um ein T:System.Globalization.NumberFormatInfo- oder . Wenn provider
NULL ist oder T T:System.Globalization.NumberFormatInfo nicht abgerufen werden kann, werden die Formatierungsinformationen für die aktuelle Systemkultur verwendet.
Wenn Sie normalerweise die M:System.nfloat.Parse* -Methode übergeben, eine Zeichenfolge, die durch Aufrufen der - Methode erstellt wird, wird der ursprüngliche nfloat Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus wird beim Versuch, die Zeichenfolgendarstellung von MinValue oder MaxValue zu analysieren, eine T:System.OverflowException ausgelöst.
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 P:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator, P:System.Globalization.NumberFormatInfo.NumberDecimalSeparator, P: System.Globalization.NumberFormatInfo.CurrencyGroupSeparator und P:System.Globalization.NumberFormatInfo.NumberGroupSeparator.
Gilt für:
Parse(String, NumberStyles, IFormatProvider)
public static nfloat Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> nfloat
Parameter
- s
- String
- style
- NumberStyles
- provider
- IFormatProvider