Double.TryParse Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Konvertiert die Zeichenfolgendarstellung einer Zahl in dessen Gleitkommazahläquivalent mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

Überlädt

TryParse(String, IFormatProvider, Double)	Versucht, eine Zeichenfolge in einen Wert zu analysieren.
TryParse(ReadOnlySpan<Char>, Double)	Wandelt die Spandarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format in das Gleitkommazahlenäquivalent mit doppelter Genauigkeit um. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
TryParse(String, Double)	Konvertiert die Zeichenfolgendarstellung einer Zahl in dessen Gleitkommazahläquivalent mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)	Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)	Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Double)	Versucht, eine Spanne von UTF-8 Zeichen in einen Wert zu analysieren.
TryParse(ReadOnlySpan<Byte>, Double)	Versucht, einen UTF-8-Zeichenbereich mit der Zeichenfolgendarstellung einer Zahl in seine Gleitkommazahläquivalent mit doppelter Genauigkeit zu konvertieren.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Double)	Konvertiert einen Zeichenbereich, der die Zeichenfolgendarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format enthält, in dessen Gleitkommazahlenäquivalent mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.
TryParse(String, NumberStyles, IFormatProvider, Double)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in dessen Gleitkommazahläquivalent mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

Hinweise

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

TryParse(String, IFormatProvider, Double)

Quelle:

Double.cs

Versucht, eine Zeichenfolge in einen Wert zu analysieren.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] double % result) = IParsable<double>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out double result);

static member TryParse : string * IFormatProvider * double -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

s

String

Die zu analysierende Zeichenfolge.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Double

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

Gibt zurück

Boolean

true, wenn s erfolgreich analysiert wurde; andernfalls false.

TryParse(ReadOnlySpan<Char>, Double)

Quelle:

Double.cs

Wandelt die Spandarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format in das Gleitkommazahlenäquivalent mit doppelter 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] double % result);

public static bool TryParse (ReadOnlySpan<char> s, out double result);

static member TryParse : ReadOnlySpan<char> * double -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Double) As Boolean

Parameter

s

ReadOnlySpan<Char>

Ein Zeichenbereich, der die Zeichenfolgendarstellung der zu konvertierenden Zahl enthält.

result

Double

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit doppelter Genauigkeit des numerischen Werts oder Symbols, der in s Parameter enthalten ist, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter snull oder leer ist. Wenn s eine gültige Zahl kleiner als Double.MinValue-ist, ist resultNegativeInfinity. Wenn s eine gültige Zahl größer als Double.MaxValueist, ist resultPositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result angegebenen 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ß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.

TryParse(String, Double)

Quelle:

Double.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in dessen Gleitkommazahläquivalent mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] double % result);

public static bool TryParse (string? s, out double result);

static member TryParse : string * double -> bool

Public Shared Function TryParse (s As String, ByRef result As Double) As Boolean

Parameter

s

String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll.

result

Double

Wenn diese Methode zurückgegeben wird, enthält sie die Gleitkommazahl mit doppelter Genauigkeit des s Parameters, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter snull oder Empty ist oder keine Zahl in einem gültigen Format ist. Es schlägt auch unter .NET Framework und .NET Core 2.2 und früheren Versionen fehl, wenn s eine Zahl kleiner als Double.MinValue- oder größer als Double.MaxValue-darstellt. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result angegebenen Werte werden überschrieben.

Gibt zurück

Boolean

true, wenn s erfolgreich konvertiert wurde; andernfalls false.

Beispiele

Im folgenden Beispiel wird die TryParse(String, Double)-Methode verwendet, um die Zeichenfolgendarstellungen numerischer Werte in Double Werte zu konvertieren. Es wird davon ausgegangen, dass en-US die aktuelle Kultur ist.

using System;

public class Example
{
   public static void Main()
   {
      string[] values = { "1,643.57", "$1,643.57", "-1.643e6",
                          "-168934617882109132", "123AE6",
                          null, String.Empty, "ABCDEF" };
      double number;

      foreach (var value in values) {
         if (Double.TryParse(value, out number))
            Console.WriteLine("'{0}' --> {1}", value, number);
         else
            Console.WriteLine("Unable to parse '{0}'.", value);
      }
   }
}
// The example displays the following output:
//       '1,643.57' --> 1643.57
//       Unable to parse '$1,643.57'.
//       '-1.643e6' --> -1643000
//       '-168934617882109132' --> -1.68934617882109E+17
//       Unable to parse '123AE6'.
//       Unable to parse ''.
//       Unable to parse ''.
//       Unable to parse 'ABCDEF'.

open System

let values =
    [| "1,643.57"; "$1,643.57"; "-1.643e6"
       "-168934617882109132"; "123AE6"
       null; String.Empty; "ABCDEF" |]

for value in values do
    match Double.TryParse value with
    | true, number ->
        printfn $"'{value}' --> {number}"
    | _ ->
        printfn $"Unable to parse '{value}'."
// The example displays the following output:
//       '1,643.57' --> 1643.57
//       Unable to parse '$1,643.57'.
//       '-1.643e6' --> -1643000
//       '-168934617882109132' --> -1.68934617882109E+17
//       Unable to parse '123AE6'.
//       Unable to parse ''.
//       Unable to parse ''.
//       Unable to parse 'ABCDEF'.

Module Example
   Public Sub Main()
      Dim values() As String = { "1,643.57", "$1,643.57", "-1.643e6", 
                                "-168934617882109132", "123AE6", 
                                Nothing, String.Empty, "ABCDEF" }
      Dim number As Double
      
      For Each value In values
         If Double.TryParse(value, number) Then
            Console.WriteLine("'{0}' --> {1}", value, number)
         Else
            Console.WriteLine("Unable to parse '{0}'.", value)      
         End If   
      Next   
   End Sub
End Module
' The example displays the following output:
'       '1,643.57' --> 1643.57
'       Unable to parse '$1,643.57'.
'       '-1.643e6' --> -1643000
'       '-168934617882109132' --> -1.68934617882109E+17
'       Unable to parse '123AE6'.
'       Unable to parse ''.
'       Unable to parse ''.
'       Unable to parse 'ABCDEF'.

Hinweise

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

Diese Überladung unterscheidet sich von der Double.Parse(String)-Methode durch Zurückgeben eines booleschen Werts, der angibt, ob der Analysevorgang erfolgreich war, anstatt den analysierten numerischen Wert zurückzugeben. Es beseitigt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um eine FormatException zu testen, wenn s ungültig ist und nicht erfolgreich analysiert werden kann.

Der parameter s kann die NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol der aktuellen Kultur enthalten (bei dem Zeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet), oder eine Zeichenfolge des Formulars:

[ws] [Zeichen] [Integralziffern,]Integralziffern[.[ Dezimalstellen]][e[Zeichen]exponentielle Ziffern][ws]

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
ws	Eine Reihe von Leerzeichen.
signieren	Ein negatives Oder positives Zeichensymbol.
Integralziffern	Eine Reihe numerischer Zeichen zwischen 0 und 9, die den integralen Teil der Zahl angeben. Integralziffern können fehlen, wenn Bruchzahlen vorhanden sind.
,	Ein kulturspezifisches Gruppentrennzeichen.
.	Ein kulturspezifisches Dezimalkommasymbol.
Dezimalstellen	Eine Reihe numerischer Zeichen zwischen 0 und 9, die den Bruchteil der Zahl angeben.
E-	Ein Groß- oder Kleinbuchstaben "e", das die exponentielle (wissenschaftliche) Schreibweise angibt.
exponentiellen Ziffern	Eine Reihe numerischer Zeichen zwischen 0 und 9, die einen Exponenten angeben.

Weitere Informationen zu numerischen Formaten finden Sie unter Formatierungstypen.

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

Der s-Parameter wird mithilfe der Formatierungsinformationen in einem NumberFormatInfo-Objekt analysiert, das für die aktuelle Systemkultur initialisiert wird. Weitere Informationen finden Sie unter NumberFormatInfo.CurrentInfo. Um eine Zeichenfolge mithilfe der Formatierungsinformationen einer anderen angegebenen Kultur zu analysieren, verwenden Sie die Double.TryParse(String, NumberStyles, IFormatProvider, Double) Methodenüberladung.

Wenn Sie die Double.TryParse Methode übergeben, wird in ordnungsmäßiger Weise eine Zeichenfolge übergeben, die durch Aufrufen der Double.ToString-Methode erstellt wird, der ursprüngliche Double Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus kann beim Versuch, die Zeichenfolgendarstellung von Double.MinValue oder Double.MaxValue zu analysieren, das Roundtrip fehlschlägt. In .NET Framework und .NET Core 2.2 und früheren Versionen wird ein OverflowExceptionausgelöst. In .NET Core 3.0 und höheren Versionen wird Double.NegativeInfinity zurückgegeben, wenn Sie versuchen, MinValue oder Double.PositiveInfinity zu analysieren, wenn Sie versuchen, MaxValuezu analysieren. Das folgende Beispiel enthält eine Abbildung.

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;

      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);

      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

open System

[<EntryPoint>]
let main _ = 
    let value = string Double.MinValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    let value = string Double.MaxValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    0
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.

Wenn s außerhalb des Double-Datentyps liegt, löst die TryParse(String, Double)-Methode unter .NET Framework und .NET Core 2.2 und früheren Versionen einen OverflowExceptionaus.

In .NET Core 3.0 und höheren Versionen wird keine Ausnahme ausgelöst, wenn s außerhalb des Bereichs des Double Datentyps liegt. In den meisten Fällen berechnet die TryParse(String, Double)-Methode ein Ergebnis von Double.PositiveInfinity oder Double.NegativeInfinity. Es gibt jedoch eine kleine Gruppe von Werten, die als näher an den Höchst- oder Mindestwerten von Double als positive oder negative Unendlichkeit angesehen werden. In diesen Fällen berechnet die Methode ein Ergebnis von Double.MaxValue oder Double.MinValue.

Wenn während eines Analysevorgangs ein Trennzeichen im s-Parameter gefunden wird und die Dezimal- 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-
• Beispiel: .NET Core WinForms Formatting Utility (C#)
• Beispiel: .NET Core WinForms Formatting Utility (Visual Basic)

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

Quelle:

Double.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] double % result) = IUtf8SpanParsable<double>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out double result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * double -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Textbereitstellt.

result

Double

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

Gibt zurück

Boolean

true, wenn utf8Text erfolgreich analysiert wurde; andernfalls false.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

Quelle:

Double.cs

Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] double % result) = ISpanParsable<double>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out double result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * double -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

s

ReadOnlySpan<Char>

Die Spanne der zu analysierenden Zeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Double

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

Gibt zurück

Boolean

true, wenn s erfolgreich analysiert wurde; andernfalls false.

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

Quelle:

Double.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] double % result) = System::Numerics::INumberBase<double>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out double result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * double -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Die Spanne von UTF-8 Zeichen, die analysiert werden sollen.

style

NumberStyles

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

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Textbereitstellt.

result

Double

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

Gibt zurück

Boolean

true, wenn utf8Text erfolgreich analysiert wurde; andernfalls false.

TryParse(ReadOnlySpan<Byte>, Double)

Quelle:

Double.cs

Versucht, einen UTF-8-Zeichenbereich mit der Zeichenfolgendarstellung einer Zahl in seine Gleitkommazahläquivalent mit doppelter Genauigkeit zu konvertieren.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] double % result);

public static bool TryParse (ReadOnlySpan<byte> utf8Text, out double result);

static member TryParse : ReadOnlySpan<byte> * double -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Double) As Boolean

Parameter

utf8Text

ReadOnlySpan<Byte>

Eine schreibgeschützte UTF-8-Zeichenspanne, die die zu konvertierende Zahl enthält.

result

Double

Wenn diese Methode zurückgegeben wird, enthält sie eine Gleitkommazahl mit doppelter Genauigkeit des numerischen Werts oder Symbols, der in utf8Text enthalten ist, wenn die Konvertierung erfolgreich war oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn die utf8TextEmpty ist oder kein gültiges Format aufweist. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich im Ergebnis angegebenen Werte werden überschrieben.

Gibt zurück

Boolean

true, wenn utf8Text erfolgreich konvertiert wurde; andernfalls false.

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

Quelle:

Double.cs

Konvertiert einen Zeichenbereich, der die Zeichenfolgendarstellung einer Zahl in einem angegebenen Format und kulturspezifischen Format enthält, in dessen Gleitkommazahlenäquivalent mit doppelter Genauigkeit. 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] double % result) = System::Numerics::INumberBase<double>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out double result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * double -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

s

ReadOnlySpan<Char>

Eine schreibgeschützte Zeichenspanne, die die zu konvertierende Zahl enthält.

style

NumberStyles

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

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Double

Wenn diese Methode zurückgegeben wird und die Konvertierung erfolgreich war, enthält sie eine Gleitkommazahl mit doppelter Genauigkeit des numerischen Werts oder Symbols, der in senthalten ist. Enthält Null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der parameter snullist, ein leerer Zeichenbereich oder keine Zahl in einem Format, das mit stylekompatibel ist. Wenn s eine gültige Zahl kleiner als Double.MinValue-ist, ist resultNegativeInfinity. Wenn s eine gültige Zahl größer als Double.MaxValueist, ist resultPositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result angegebenen 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ß für die Darstellung sind, auf PositiveInfinity oder NegativeInfinity gerundet, wie in der IEEE 754-Spezifikation erforderlich. In früheren Versionen, einschließlich .NET Framework, hat die Analyse eines Werts, der zu groß war, zu einem Fehler geführt.

TryParse(String, NumberStyles, IFormatProvider, Double)

Quelle:

Double.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einer angegebenen Formatvorlage und einem kulturspezifischen Format in dessen Gleitkommazahläquivalent mit doppelter 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] double % result) = System::Numerics::INumberBase<double>::TryParse;

public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out double result);

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * double -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Double) As Boolean

Parameter

s

String

Eine Zeichenfolge, die eine zahl enthält, die konvertiert werden soll.

style

NumberStyles

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

provider

IFormatProvider

Eine IFormatProvider, die kulturspezifische Formatierungsinformationen zu sbereitstellt.

result

Double

Wenn diese Methode zurückgegeben wird, enthält sie eine Gleitkommazahl mit doppelter Genauigkeit des numerischen Werts oder Symbols, der in senthalten ist, wenn die Konvertierung erfolgreich war, oder null, wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s Parameter null oder Empty ist oder nicht in einem Format vorliegt, das mit stylekompatibel ist, oder wenn style keine gültige Kombination aus NumberStyles Enumerationskonstanten ist. Es schlägt auch unter .NET Framework oder .NET Core 2.2 und früheren Versionen fehl, wenn s eine Zahl kleiner als SByte.MinValue oder größer als SByte.MaxValuedarstellt. Dieser Parameter wird nicht initialisiert übergeben. alle ursprünglich in result angegebenen Werte werden überschrieben.

Gibt zurück

Boolean

true, wenn s erfolgreich konvertiert wurde; andernfalls false.

Ausnahmen

ArgumentException

style ist kein NumberStyles Wert.

-oder-

style enthält den AllowHexSpecifier Wert.

Beispiele

Im folgenden Beispiel wird die Verwendung der Double.TryParse(String, NumberStyles, IFormatProvider, Double)-Methode veranschaulicht, um die Zeichenfolgendarstellung von Zahlen zu analysieren, die eine bestimmte Formatvorlage aufweisen und mithilfe der Konventionen einer bestimmten Kultur formatiert sind.

string value;
NumberStyles style;
CultureInfo culture;
double number;

// Parse currency value using en-GB culture.
value = "£1,097.63";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
culture = CultureInfo.CreateSpecificCulture("en-GB");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '£1,097.63' to 1097.63.

value = "1345,978";
style = NumberStyles.AllowDecimalPoint;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '1345,978' to 1345.978.

value = "1.345,978";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
culture = CultureInfo.CreateSpecificCulture("es-ES");
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Converted '1.345,978' to 1345.978.

value = "1 345,978";
if (Double.TryParse(value, style, culture, out number))
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
else
   Console.WriteLine("Unable to convert '{0}'.", value);
// Displays:
//       Unable to convert '1 345,978'.

// Parse currency value using en-GB culture.
let value = "£1,097.63"
let style = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol
let culture = CultureInfo.CreateSpecificCulture "en-GB"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '£1,097.63' to 1097.63.

let value = "1345,978"
let style = NumberStyles.AllowDecimalPoint
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '1345,978' to 1345.978.

let value = "1.345,978"
let style = NumberStyles.AllowDecimalPoint ||| NumberStyles.AllowThousands
let culture = CultureInfo.CreateSpecificCulture("es-ES")
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Converted '1.345,978' to 1345.978.

let value = "1 345,978"
match Double.TryParse(value, style, culture) with
| true, number ->
    printfn $"Converted '{value}' to {number}."
| _ ->
    printfn $"Unable to convert '{value}'."
// Displays:
//       Unable to convert '1 345,978'.

Dim value As String
Dim style As NumberStyles
Dim culture As CultureInfo
Dim number As Double

' Parse currency value using en-GB culture.
value = "£1,097.63"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
culture = CultureInfo.CreateSpecificCulture("en-GB")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '£1,097.63' to 1097.63.

value = "1345,978"
style = NumberStyles.AllowDecimalPoint
culture = CultureInfo.CreateSpecificCulture("fr-FR")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Converted '1345,978' to 1345.978.

value = "1.345,978"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
culture = CultureInfo.CreateSpecificCulture("es-ES")
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays: 
'       Converted '1.345,978' to 1345.978.

value = "1 345,978"
If Double.TryParse(value, style, culture, number) Then
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Else
   Console.WriteLine("Unable to convert '{0}'.", value)
End If    
' Displays:
'       Unable to convert '1 345,978'.

Hinweise

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

Die TryParse-Methode entspricht der Parse(String, NumberStyles, IFormatProvider)-Methode, außer diese Methode löst keine Ausnahme aus, wenn die Konvertierung fehlschlägt. Wenn die Konvertierung erfolgreich ist, wird der Rückgabewert true und der parameter result auf das Ergebnis der Konvertierung festgelegt. Wenn die Konvertierung fehlschlägt, wird der Rückgabewert false und der parameter result auf Null festgelegt. Dadurch ist es nicht erforderlich, die Ausnahmebehandlung zum Testen einer FormatException zu verwenden, wenn s ungültig ist und nicht erfolgreich analysiert werden kann.

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

• NumberStyles.AllowHexSpecifier

• NumberStyles.HexNumber

Der parameter s kann NumberFormatInfo.PositiveInfinitySymbol, NumberFormatInfo.NegativeInfinitySymboloder NumberFormatInfo.NaNSymbol für die kultur enthalten, die durch providerangegeben wird. Je nach Wert von stylekann der parameter s außerdem die folgenden Elemente enthalten:

[ws] [$] [Zeichen] [Integralziffern,]integrale Ziffern[.bruchstellen][e[Zeichen]Exponentielle Ziffern][ws]

Elemente in eckigen Klammern ([ und ]) sind optional. In der folgenden Tabelle werden die einzelnen Elemente beschrieben.

Element	Beschreibung
ws	Optionaler Leerraum. Leerzeichen können am Anfang s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite Flag enthält. Sie kann am Ende der s angezeigt werden, wenn style das NumberStyles.AllowTrailingWhite Flag enthält.
$	Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die eigenschaften NumberFormatInfo.CurrencyNegativePattern oder NumberFormatInfo.CurrencyPositivePattern des NumberFormatInfo Objekts definiert, das von der IFormatProvider.GetFormat Methode des provider Parameters zurückgegeben wird. Das Währungssymbol kann in s angezeigt werden, wenn style das NumberStyles.AllowCurrencySymbol Flag enthält.
signieren	Ein optionales Zeichen. Das Zeichen kann am Anfang der s angezeigt werden, wenn style das NumberStyles.AllowLeadingSign Flag enthält, und es kann am Ende s angezeigt werden, wenn style das NumberStyles.AllowTrailingSign Flag enthält. Klammern können in s verwendet werden, um einen negativen Wert anzugeben, wenn style das NumberStyles.AllowParentheses Flag enthält.
Integralziffern	Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Integralziffern können fehlen, wenn Bruchzahlen vorhanden sind.
,	Ein kulturspezifisches Tausendertrennzeichen. Das Tausendertrennzeichen der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowThousands Flag enthält.
.	Ein kulturspezifisches Dezimalkommasymbol. Das Dezimalkommasymbol der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthält.
Dezimalstellen	Eine Reihe von Ziffern zwischen 0 und 9, die den Bruchteil der Zahl angeben. Dezimalstellen können in s angezeigt werden, wenn style das kennzeichen NumberStyles.AllowDecimalPoint enthält.
e	Das E- oder E-Zeichen, das angibt, dass s eine Zahl mit exponentieller Schreibweise darstellen kann. Der s-Parameter kann eine Zahl in exponentieller Notation darstellen, wenn die Formatvorlage das NumberStyles.AllowExponent Flag enthält.
exponentiellen Ziffern	Eine Reihe von Ziffern zwischen 0 und 9, die einen Exponenten angeben.

Anmerkung

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

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

NumberStyles-Wert	Elemente, die zusätzlich zu Ziffern in s zulässig sind
None	Nur die Integralziffern Element.
AllowDecimalPoint	Die . und Bruchzahlen Elemente.
AllowExponent	Der parameter s kann auch exponentielle Notation verwenden. Diese Kennzeichnung unterstützt selbst Werte in form integralziffernEexponentiellen Ziffern; Zusätzliche Flags werden benötigt, um Zeichenfolgen in exponentieller Notation mit Elementen wie positiven oder negativen Zeichen und Dezimalkommasymbolen erfolgreich zu analysieren.
AllowLeadingWhite	Das ws-Element am Anfang s.
AllowTrailingWhite	Das ws-Element am Ende s.
AllowLeadingSign	Das signieren Element am Anfang s.
AllowTrailingSign	Das signieren Element am Ende s.
AllowParentheses	Das Zeichen Element in Form von Klammern, die den numerischen Wert einschließen.
AllowThousands	Das --Element.
AllowCurrencySymbol	Das $-Element.
Currency	Alle. Der parameter s kann keine hexadezimale Zahl oder eine Zahl in exponentieller Schreibweise darstellen.
Float	Das ws-Element am Anfang oder Ende s, Zeichen am Anfang s, und die .-Symbol. Der parameter s kann auch exponentielle Notation verwenden.
Number	Das ws-, sign- Tausendertrennzeichen (,), und Dezimalkomma (.) Elemente.
Any	Alle Formatvorlagen, mit Ausnahme von s, können keine hexadezimale Zahl darstellen.

Der provider-Parameter ist eine IFormatProvider Implementierung, z. B. ein NumberFormatInfo- oder CultureInfo-Objekt. Der parameter provider liefert kulturspezifische Informationen, die bei der Analyse verwendet werden. Wenn providernull oder ein NumberFormatInfo Objekt nicht abgerufen werden kann, werden die Formatinformationen für die aktuelle Kultur verwendet.

Die Konvertierung schlägt fehl, wenn der s Parameter null oder kein numerischer Wert ist, der parameter provider kein NumberFormatInfo-Objekt zurückgibt, oder der style Parameter ist keine Kombination aus Bitkennzeichnungen aus der NumberStyles Enumeration.

Wenn Sie die Double.TryParse Methode übergeben, wird in ordnungsmäßiger Weise eine Zeichenfolge übergeben, die durch Aufrufen der Double.ToString-Methode erstellt wird, der ursprüngliche Double Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus kann beim Versuch, die Zeichenfolgendarstellung von Double.MinValue oder Double.MaxValue zu analysieren, das Roundtrip fehlschlägt. In .NET Framework und .NET Core 2.2 und früheren Versionen wird ein OverflowExceptionausgelöst. In .NET Core 3.0 und höheren Versionen wird Double.NegativeInfinity zurückgegeben, wenn Sie versuchen, MinValue oder Double.PositiveInfinity zu analysieren, wenn Sie versuchen, MaxValuezu analysieren. Das folgende Beispiel enthält eine Abbildung.

using System;

public class Example
{
   public static void Main()
   {
      string value;
      double number;

      value = Double.MinValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);

      value = Double.MaxValue.ToString();
      if (Double.TryParse(value, out number))
         Console.WriteLine(number);
      else
         Console.WriteLine("{0} is outside the range of a Double.",
                           value);
   }
}
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

open System

[<EntryPoint>]
let main _ = 
    let value = string Double.MinValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    let value = string Double.MaxValue
    match Double.TryParse value with
    | true, number ->
        printfn $"{number}"
    | _ ->
        printfn $"{value} is outside the range of a Double."

    0
// The example displays the following output:
//    -1.79769313486232E+308 is outside the range of the Double type.
//    1.79769313486232E+308 is outside the range of the Double type.

Module Example
   Public Sub Main()
      Dim value As String
      Dim number As Double
      
      value = Double.MinValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
      
      value = Double.MaxValue.ToString()
      If Double.TryParse(value, number) Then
         Console.WriteLine(number)
      Else
         Console.WriteLine("{0} is outside the range of a Double.", _
                           value)
      End If
   End Sub
End Module
' The example displays the following output:
'    -1.79769313486232E+308 is outside the range of the Double type.
'    1.79769313486232E+308 is outside the range of the Double type.

Wenn s außerhalb des Double-Datentyps liegt, löst die Double.TryParse(String, NumberStyles, IFormatProvider, Double)-Methode unter .NET Framework und .NET Core 2.2 und früheren Versionen einen OverflowExceptionaus.

In .NET Core 3.0 und höheren Versionen wird keine Ausnahme ausgelöst, wenn s außerhalb des Bereichs des Double Datentyps liegt. In den meisten Fällen berechnet die Double.TryParse(String, NumberStyles, IFormatProvider, Double)-Methode ein Ergebnis von Double.PositiveInfinity oder Double.NegativeInfinity. Es gibt jedoch eine kleine Gruppe von Werten, die als näher an den Höchst- oder Mindestwerten von Double als positive oder negative Unendlichkeit angesehen werden. In diesen Fällen berechnet die Methode ein Ergebnis von Double.MaxValue oder Double.MinValue.

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

• ToString()
• Analysieren numerischer Zeichenfolgen in .NET-