Double.TryParse Methode

Definition

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

Überlädt

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

Versucht, eine Spanne von Zeichen in einen Wert zu analysieren.

TryParse(ReadOnlySpan<Char>, Double)

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

TryParse(String, Double)

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

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

Versucht, eine Spanne von UTF-8-Zeichen in einen Wert zu analysieren.

TryParse(String, IFormatProvider, Double)

Versucht, eine Zeichenfolge 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, eine UTF-8-Zeichenspanne, die die Zeichenfolgendarstellung einer Zahl enthält, in die entsprechende Gleitkommazahl mit doppelter Genauigkeit zu konvertieren.

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

Konvertiert eine Zeichenspanne mit der Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende Gleitkommazahl mit doppelter Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

TryParse(String, NumberStyles, IFormatProvider, Double)

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

Hinweise

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, Double)

Source:
Double.cs
Source:
Double.cs
Source:
Double.cs

Versucht, eine Spanne 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 s bereitstellt.

result
Double

Wenn diese Methode zurückgibt, enthält das Ergebnis der erfolgreichen sAnalyse oder einen undefinierten Wert bei Einem Fehler.

Gibt zurück

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

TryParse(ReadOnlySpan<Char>, Double)

Source:
Double.cs
Source:
Double.cs
Source:
Double.cs

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

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>

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

result
Double

Diese Methode gibt bei erfolgreicher Konvertierung die Gleitkommazahl mit doppelter Genauigkeit zurück, die dem numerischen Wert oder dem im s-Parameter enthaltenen Symbol entspricht, oder 0 (null), wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s-Parameter gleich null oder leer ist oder nicht in einem Format vorliegt, das mit style kompatibel ist. Die Konvertierung schlägt auch fehl, wenn style keine gültige Kombination von enumerierten NumberStyles-Konstanten ist. Wenn s eine gültige Zahl kleiner als Double.MinValue ist, result ist NegativeInfinity. Wenn s eine gültige Zahl größer als Double.MaxValue ist, result ist PositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Hinweise

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

Gilt für:

TryParse(String, Double)

Source:
Double.cs
Source:
Double.cs
Source:
Double.cs

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

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] double % result);
public static bool TryParse (string s, 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 die zu konvertierende Zahl enthält.

result
Double

Wenn diese Methode zurückgegeben wird, enthält sie bei erfolgreicher Konvertierung eine Gleitkommazahl mit doppelter Genauigkeit, die dem s-Parameter entspricht, oder 0 (null), wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der s-Parameter null, Empty oder keine Zahl im gültigen Format ist. Außerdem tritt bei .NET Framework und .NET Core 2.2 und früheren Versionen ein Fehler auf, wenn s eine Zahl kleiner als Double.MinValue oder größer als Double.MaxValue ist. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

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

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

Der s Parameter kann die aktuelle Kultur NumberFormatInfo.PositiveInfinitySymbolenthalten, NumberFormatInfo.NegativeInfinitySymbol, NumberFormatInfo.NaNSymbol (beim Zeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet) oder eine Zeichenfolge im Format:

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

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

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

Weitere Informationen zu numerischen Formaten finden Sie unter Formatierungstypen.

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

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

Wenn Sie der Double.TryParse Methode normalerweise eine Zeichenfolge übergeben, die durch Aufrufen der Double.ToString -Methode erstellt wird, wird der ursprüngliche Double Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus schlägt der Versuch, die Zeichenfolgendarstellung von oder Double.MinValueDouble.MaxValue zu analysieren, einen Roundtrip fehl. Unter .NET Framework und .NET Core 2.2 und früheren Versionen wird eine OverflowExceptionausgelöst. Unter .NET Core 3.0 und höheren Versionen wird Double.NegativeInfinity zurückgegeben, wenn Sie versuchen, zu analysieren MinValue oder Double.PositiveInfinity zu analysieren MaxValue. Dies wird im folgenden Beispiel veranschaulicht.

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 sich .NET Framework und .NET Core 2.2 und früheren Versionen s außerhalb des Bereichs des Double Datentyps befindet, löst die TryParse(String, Double) -Methode eine ausOverflowException.

Unter .NET Core 3.0 und höheren Versionen wird keine Ausnahme ausgelöst, wenn s sich außerhalb des Bereichs des Datentyps Double befindet. 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 Maximal- oder Minimalwerten von Double als an positiver oder negativer Unendlichkeit liegen. In diesen Fällen berechnet die -Methode ein Ergebnis von Double.MaxValue oder Double.MinValue.

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

Weitere Informationen

Gilt für:

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Double)

Source:
Double.cs
Source:
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 der zu analysierenden UTF-8-Zeichen.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text bereitstellt.

result
Double

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

Gibt zurück

true , wenn utf8Text erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

TryParse(String, IFormatProvider, Double)

Source:
Double.cs
Source:
Double.cs
Source:
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 s bereitstellt.

result
Double

Wenn diese Methode zurückgibt, enthält das Ergebnis der erfolgreichen s Analyse oder einen nicht definierten Wert bei Einem Fehler.

Gibt zurück

true , wenn s erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

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

Source:
Double.cs
Source:
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 der zu analysierenden UTF-8-Zeichen.

style
NumberStyles

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

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu utf8Text bereitstellt.

result
Double

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

Gibt zurück

true , wenn utf8Text erfolgreich analysiert wurde, falseandernfalls .

Gilt für:

TryParse(ReadOnlySpan<Byte>, Double)

Source:
Double.cs
Source:
Double.cs

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

Gibt zurück

true, wenn utf8Text erfolgreich konvertiert wurde, andernfalls false.

Gilt für:

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

Source:
Double.cs
Source:
Double.cs
Source:
Double.cs

Konvertiert eine Zeichenspanne mit der Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende Gleitkommazahl mit doppelter 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] double % result);
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);
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 von NumberStyles-Werten, 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
Double

Diese Methode gibt bei erfolgreicher Konvertierung eine Gleitkommazahl mit doppelter Genauigkeit zurück, die dem numerischen Wert oder dem im s-Parameter enthaltenen Symbol entspricht, oder 0 (null), wenn die Konvertierung fehlgeschlagen ist. Die Konvertierung schlägt fehl, wenn der Parameter snull oder eine leere Zeichenspanne ist oder nicht in einem Format vorliegt, das mit style kompatibel ist. Wenn s eine gültige Zahl kleiner als Double.MinValue ist, result ist NegativeInfinity. Wenn s eine gültige Zahl größer als Double.MaxValue ist, result ist PositiveInfinity. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Hinweise

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

Gilt für:

TryParse(String, NumberStyles, IFormatProvider, Double)

Source:
Double.cs
Source:
Double.cs
Source:
Double.cs

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende Gleitkommazahl mit doppelter 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] double % result);
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);
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 die zu konvertierende Zahl enthält.

style
NumberStyles

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

provider
IFormatProvider

Eine IFormatProvider-Schnittstelle, die kulturspezifische Formatierungsinformationen zu s bereitstellt.

result
Double

Diese Methode gibt bei erfolgreicher Konvertierung eine Gleitkommazahl mit doppelter Genauigkeit zurück, die dem numerischen Wert oder dem im s-Parameter enthaltenen Symbol entspricht, oder 0 (null), wenn die Konvertierung fehlgeschlagen ist. 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. Außerdem tritt auf .NET Framework oder .NET Core 2.2 und früheren Versionen ein Fehler auf, wenn s eine Zahl kleiner als SByte.MinValue oder größer als SByte.MaxValue ist. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.

Ausnahmen

style ist kein NumberStyles-Wert.

- oder -

style enthält den AllowHexSpecifier-Wert.

Beispiele

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

Die TryParse -Methode ähnelt der Parse(String, NumberStyles, IFormatProvider) -Methode, mit der Ausnahme, dass diese Methode keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt. Wenn die Konvertierung erfolgreich ist, ist true der Rückgabewert, und der result Parameter wird auf das Ergebnis der Konvertierung festgelegt. Wenn die Konvertierung fehlschlägt, ist false der Rückgabewert, und der result Parameter wird auf 0 festgelegt. Dadurch entfällt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um im Fall eines FormatException zu testen, das s ungültig ist und nicht erfolgreich analysiert werden kann.

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

Der s Parameter kann , NumberFormatInfo.NegativeInfinitySymboloder NumberFormatInfo.NaNSymbol für die kultur enthaltenNumberFormatInfo.PositiveInfinitySymbol, die durch angegeben wirdprovider. Außerdem kann der s Parameter abhängig vom Wert von styledie folgenden Elemente enthalten:

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

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

Element Beschreibung
ws Optionaler Leerraum. Leerzeichen können am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite Flag enthalten ist. Es kann am Ende von s angezeigt werden, wenn style das NumberStyles.AllowTrailingWhite Flag enthält.
$ Ein kulturspezifisches Währungssymbol. Seine Position in der Zeichenfolge wird durch die NumberFormatInfo.CurrencyNegativePattern Eigenschaften oder NumberFormatInfo.CurrencyPositivePattern des Objekts definiert, das NumberFormatInfo von der IFormatProvider.GetFormat -Methode des provider Parameters zurückgegeben wird. Das Währungssymbol kann in s angezeigt werden, wenn style das NumberStyles.AllowCurrencySymbol Flag enthält.
sign Ein optionales Zeichen. Das Zeichen kann am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingSign Flag enthält, und es kann am Ende von s angezeigt werden, wenn style das NumberStyles.AllowTrailingSign Flag enthält. Klammern können in s verwendet werden, um einen negativen Wert anzugeben, wenn style das NumberStyles.AllowParentheses Flag enthalten ist.
Ganzzahlige Ziffern Eine Reihe von Ziffern zwischen 0 und 9, die den integralen Teil der Zahl angeben. Ganzzahlige Ziffern können fehlen, wenn Bruchstellen vorhanden sind.
, Ein kulturspezifisches Tausendertrennzeichen. Das Tausendertrennzeichen der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowThousands Flag enthält.
. Ein kulturspezifisches Dezimaltrennzeichen. Das Dezimalzeichensymbol der aktuellen Kultur kann in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthält.
Bruchstellen Eine Reihe von Ziffern im Bereich von 0 bis 9, die den Bruchteil der Zahl angeben. Teilziffern können in s angezeigt werden, wenn style das NumberStyles.AllowDecimalPoint Flag enthalten ist.
e Das Zeichen e oder E, das angibt, dass s eine Zahl mit exponentieller Notation darstellen kann. Der s Parameter kann eine Zahl in exponentieller Notation darstellen, wenn style das NumberStyles.AllowExponent Flag enthält.
exponentielle Ziffern Eine Reihe von Ziffern im Bereich von 0 bis 9, die einen Exponenten angeben.

Hinweis

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

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

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

Der provider Parameter ist eine IFormatProvider Implementierung, z. B. ein - oder CultureInfo -NumberFormatInfoObjekt. Der provider Parameter stellt kulturspezifische Informationen bereit, die bei der Analyse verwendet werden. Wenn provider ist null 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 ein numerischer Wert ist null oder nicht, der provider Parameter kein Objekt ergibt NumberFormatInfo oder der style Parameter keine Kombination von Bitflags aus der NumberStyles Enumeration ist.

Wenn Sie der Double.TryParse Methode normalerweise eine Zeichenfolge übergeben, die durch Aufrufen der Double.ToString -Methode erstellt wird, wird der ursprüngliche Double Wert zurückgegeben. Aufgrund eines Genauigkeitsverlusts sind die Werte jedoch möglicherweise nicht gleich. Darüber hinaus schlägt der Versuch, die Zeichenfolgendarstellung von oder Double.MinValueDouble.MaxValue zu analysieren, einen Roundtrip fehl. Unter .NET Framework und .NET Core 2.2 und früheren Versionen wird eine OverflowExceptionausgelöst. Unter .NET Core 3.0 und höheren Versionen wird Double.NegativeInfinity zurückgegeben, wenn Sie versuchen, zu analysieren MinValue oder Double.PositiveInfinity zu analysieren MaxValue. Dies wird im folgenden Beispiel veranschaulicht.

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 sich .NET Framework und .NET Core 2.2 und früheren Versionen s außerhalb des Bereichs des Double Datentyps befindet, löst die Double.TryParse(String, NumberStyles, IFormatProvider, Double) -Methode eine ausOverflowException.

Unter .NET Core 3.0 und höheren Versionen wird keine Ausnahme ausgelöst, wenn s sich außerhalb des Bereichs des Datentyps Double befindet. 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 Maximal- oder Minimalwerten von Double als an positiver oder negativer Unendlichkeit liegen. In diesen Fällen berechnet die -Methode ein Ergebnis von Double.MaxValue oder Double.MinValue.

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

Weitere Informationen

Gilt für: