UInt64.Parse Methode

Definition

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende ganze 64-Bit-Zahl ohne Vorzeichen.

Überlädt

Parse(String, NumberStyles, IFormatProvider)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

Parse(String, NumberStyles)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende ganze 64-Bit-Zahl ohne Vorzeichen.

Parse(String, IFormatProvider)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in die entsprechende ganze 64-Bit-Zahl ohne Vorzeichen.

Parse(String, NumberStyles, IFormatProvider)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Decimal.Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

public:
 static System::UInt64 Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
public static ulong Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> uint64
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> uint64
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As ULong

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt. Die Zeichenfolge wird unter Verwendung des durch den style-Parameter angegebenen Stils interpretiert.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Stilelemente angeben, die in s vorhanden sein können. Ein häufig angegebener Wert ist Integer.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.

Gibt zurück

UInt64

Eine 64-Bit-Ganzzahl ohne Vorzeichen, die der Zahl in s entspricht.

Attribute

Ausnahmen

Der s-Parameter ist null.

style ist kein NumberStyles-Wert.

- oder - style ist keine Kombination von AllowHexSpecifier- und HexNumber-Werten.

Der s-Parameter weist kein mit style kompatibles Format auf.

Der s-Parameter stellt eine Zahl dar, die kleiner als MinValue oder größer als MaxValue ist.

- oder - s enthält Dezimalstellen ungleich 0 (null).

Beispiele

Im folgenden Beispiel wird die -Methode verwendet, um verschiedene Zeichenfolgendarstellungen von Zahlen in Parse(String, NumberStyles, IFormatProvider) 64-Bit-Ganzzahlwerte ohne Vorzeichen zu konvertieren.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames= { "en-US", "fr-FR" };
      NumberStyles[] styles= { NumberStyles.Integer,
                               NumberStyles.Integer | NumberStyles.AllowDecimalPoint };
      string[] values = { "170209", "+170209.0", "+170209,0", "-103214.00",
                                 "-103214,00", "104561.1", "104561,1" };
      
      // Parse strings using each culture
      foreach (string cultureName in cultureNames)
      {
         CultureInfo ci = new CultureInfo(cultureName);
         Console.WriteLine("Parsing strings using the {0} culture", 
                           ci.DisplayName);
         // Use each style.
         foreach (NumberStyles style in styles)
         {
            Console.WriteLine("   Style: {0}", style.ToString());
            // Parse each numeric string.
            foreach (string value in values)
            {
               try {
                  Console.WriteLine("      Converted '{0}' to {1}.", value,
                                    UInt64.Parse(value, style, ci));
               }
               catch (FormatException) {
                  Console.WriteLine("      Unable to parse '{0}'.", value);
               }      
               catch (OverflowException) {
                  Console.WriteLine("      '{0}' is out of range of the UInt64 type.",
                                    value);
               }
            }
         }
      }                                    
   }
}
// The example displays the following output:
//       Style: Integer
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Unable to parse '+170209,0'.
//          Unable to parse '-103214.00'.
//          Unable to parse '-103214,00'.
//          Unable to parse '104561.1'.
//          Unable to parse '104561,1'.
//       Style: Integer, AllowDecimalPoint
//          Converted '170209' to 170209.
//          Converted '+170209.0' to 170209.
//          Unable to parse '+170209,0'.
//          '-103214.00' is out of range of the UInt64 type.
//          Unable to parse '-103214,00'.
//          '104561.1' is out of range of the UInt64 type.
//          Unable to parse '104561,1'.
//    Parsing strings using the French (France) culture
//       Style: Integer
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Unable to parse '+170209,0'.
//          Unable to parse '-103214.00'.
//          Unable to parse '-103214,00'.
//          Unable to parse '104561.1'.
//          Unable to parse '104561,1'.
//       Style: Integer, AllowDecimalPoint
//          Converted '170209' to 170209.
//          Unable to parse '+170209.0'.
//          Converted '+170209,0' to 170209.
//          Unable to parse '-103214.00'.
//          '-103214,00' is out of range of the UInt64 type.
//          Unable to parse '104561.1'.
//          '104561,1' is out of range of the UInt64 type.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR" }
      Dim styles() As NumberStyles = { NumberStyles.Integer, _
                                       NumberStyles.Integer Or NumberStyles.AllowDecimalPoint }
      Dim values() As String = { "170209", "+170209.0", "+170209,0", "-103214.00", _
                                 "-103214,00", "104561.1", "104561,1" }
      
      ' Parse strings using each culture
      For Each cultureName As String In cultureNames
         Dim ci As New CultureInfo(cultureName)
         Console.WriteLine("Parsing strings using the {0} culture", ci.DisplayName)
         ' Use each style.
         For Each style As NumberStyles In styles
            Console.WriteLine("   Style: {0}", style.ToString())
            ' Parse each numeric string.
            For Each value As String In values
               Try
                  Console.WriteLine("      Converted '{0}' to {1}.", value, _
                                    UInt64.Parse(value, style, ci))
               Catch e As FormatException
                  Console.WriteLine("      Unable to parse '{0}'.", value)   
               Catch e As OverflowException
                  Console.WriteLine("      '{0}' is out of range of the UInt64 type.", _
                                    value)         
               End Try
            Next
         Next
      Next                                    
   End Sub
End Module
' The example displays the following output:
'       Style: Integer
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Unable to parse '+170209,0'.
'          Unable to parse '-103214.00'.
'          Unable to parse '-103214,00'.
'          Unable to parse '104561.1'.
'          Unable to parse '104561,1'.
'       Style: Integer, AllowDecimalPoint
'          Converted '170209' to 170209.
'          Converted '+170209.0' to 170209.
'          Unable to parse '+170209,0'.
'          '-103214.00' is out of range of the UInt64 type.
'          Unable to parse '-103214,00'.
'          '104561.1' is out of range of the UInt64 type.
'          Unable to parse '104561,1'.
'    Parsing strings using the French (France) culture
'       Style: Integer
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Unable to parse '+170209,0'.
'          Unable to parse '-103214.00'.
'          Unable to parse '-103214,00'.
'          Unable to parse '104561.1'.
'          Unable to parse '104561,1'.
'       Style: Integer, AllowDecimalPoint
'          Converted '170209' to 170209.
'          Unable to parse '+170209.0'.
'          Converted '+170209,0' to 170209.
'          Unable to parse '-103214.00'.
'          '-103214,00' is out of range of the UInt64 type.
'          Unable to parse '104561.1'.
'          '104561,1' is out of range of the UInt64 type.

Hinweise

Der style -Parameter definiert die Stilelemente (z. B. Leerzeichen oder das positive oder negative Vorzeichensymbol), die im -Parameter zulässig sind, s damit der Analysevorgang erfolgreich ist. Dabei muss es sich um eine Kombination von Bitflags aus der NumberStyles -Enumeration handeln.

Abhängig vom Wert von style kann der Parameter die folgenden Elemente s enthalten:

[ws] [ $ ][Vorzeichen]Ziffern[.fractional_digits][E[sign]exponential_digits][ws]

Elemente in eckigen Klammern ([ und ]) sind optional. Wenn style NumberStyles.AllowHexSpecifier enthält, kann der s -Parameter die folgenden Elemente enthalten:

[ws] hexdigits[ws]

In der folgenden Tabelle wird jedes Element beschrieben.

Element Beschreibung
ws Optionaler Leerraum. Leerraum kann am Anfang von angezeigt s werden, wenn style das Flag NumberStyles.AllowLeadingWhite einschließt, und es kann am Ende von angezeigt s werden, wenn style das Flag NumberStyles.AllowTrailingWhite einschließt.
$ Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die CurrencyPositivePattern -Eigenschaft des NumberFormatInfo -Objekts definiert, das von der GetFormat -Methode des -Parameters zurückgegeben provider wird. Das Währungssymbol kann in angezeigt s werden, wenn style das Flag NumberStyles.AllowCurrencySymbol enthält.
sign Ein optionales Zeichen. (Die -Methode löst eine OverflowException aus, wenn s ein negatives Vorzeichen enthält und eine Zahl ungleich 0 (null) darstellt.) Das Vorzeichen kann am Anfang von angezeigt s werden, wenn style das Flag NumberStyles.AllowLeadingSign enthält, und es kann das Ende von angezeigt s werden, wenn das Flag style NumberStyles.AllowTrailingSign enthält. Klammern können in verwendet s werden, um einen negativen Wert anzugeben, wenn style das Flag NumberStyles.AllowParentheses einschließt.
Zahlen Eine Sequenz von Ziffern von 0 bis 9.
. Ein kulturspezifisches Dezimaltrennzeichen. Das Dezimaltrennzeichen der aktuellen Kultur kann in angezeigt s werden, wenn style das Flag NumberStyles.AllowDecimalPoint enthält.
fractional_digits Ein oder mehrere Vorkommen der Ziffer 0-9, wenn style das NumberStyles.AllowExponent Flag enthält, oder mindestens ein Vorkommen der Ziffer 0, wenn dies nicht der Fall ist. Dezimalstellen können nur in angezeigt s werden, wenn style das Flag NumberStyles.AllowDecimalPoint enthält.
E Das Zeichen "e" oder "E", das angibt, dass der Wert in exponentieller (wissenschaftlicher) Notation dargestellt wird. Der s -Parameter kann eine Zahl in exponentieller Notation darstellen, wenn style das Flag NumberStyles.AllowExponent enthält.
exponential_digits Eine Sequenz von Ziffern von 0 bis 9. Der s -Parameter kann eine Zahl in exponentieller Notation darstellen, wenn style das Flag NumberStyles.AllowExponent enthält.
hexdigits Eine Sequenz von Hexadezimalziffern von 0 bis f oder 0 bis F.

Hinweis

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

Eine Zeichenfolge mit nur Dezimalstellen (die dem NumberStyles.None Format entspricht) wird immer erfolgreich analysiert. Die meisten der verbleibenden NumberStyles Member steuern Elemente, die in dieser Eingabezeichenfolge vorhanden sein können, aber nicht vorhanden sein müssen. Die folgende Tabelle gibt an, wie sich einzelne NumberStyles Member auf die Elemente auswirken, die möglicherweise in vorhanden s sind.

Nicht zusammengesetzte NumberStyles Werte Zusätzlich zu Ziffern zulässige Elemente s
NumberStyles.None Nur Dezimalstellen.
NumberStyles.AllowDecimalPoint Das Dezimaltrennzeichen (.) und fractional_digits Elemente. Wenn der Stil jedoch nicht das NumberStyles.AllowExponent Flag enthält, darf fractional_digits nur aus mindestens einer Ziffer bestehen. Andernfalls OverflowException wird eine ausgelöst.
NumberStyles.AllowExponent Das Zeichen "e" oder "E", das die exponentielle Notation zusammen mit exponential_digits angibt.
NumberStyles.AllowLeadingWhite Das ws-Element am Anfang von s .
NumberStyles.AllowTrailingWhite Das ws-Element am Ende von s .
NumberStyles.AllowLeadingSign Ein Vorzeichen vor Ziffern.
NumberStyles.AllowTrailingSign Ein Vorzeichen nach Ziffern.
NumberStyles.AllowParentheses Klammern vor und nach Ziffern, um einen negativen Wert anzugeben.
NumberStyles.AllowThousands Das Gruppentrennzeichen (,) -Element.
NumberStyles.AllowCurrencySymbol Das currency $ ()-Element.

Wenn das NumberStyles.AllowHexSpecifier Flag verwendet wird, s muss ein Hexadezimalwert sein. Gültige Hexadezimalzeichen sind 0-9, A-F und a-f. Ein Präfix wie "0x" wird nicht unterstützt und führt dazu, dass der Analysevorgang fehlschlägt. Die einzigen anderen Flags, die damit kombiniert werden können, sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite . (Die NumberStyles -Enumeration enthält einen zusammengesetzten Zahlenstil, NumberStyles.HexNumber , der beide Leerraumflags enthält.)

Hinweis

Wenn der -Parameter die Zeichenfolgendarstellung einer Hexadezimalzahl ist, kann ihm keine Verzierung (z. B. oder ) vorangehende werden, die sie als s 0x &h hexadezimale Zahl unterscheidet. Dies bewirkt, dass der Analysevorgang eine Ausnahme auslöst.

Der provider -Parameter ist eine IFormatProvider Implementierung, GetFormat deren -Methode ein NumberFormatInfo -Objekt zurückgibt, das kulturspezifische Informationen zum Format von s enthält. Es gibt drei Möglichkeiten, den -Parameter zu provider verwenden, um benutzerdefinierte Formatierungsinformationen für den Analysevorgang zur Verfügung zu stellen:

  • Sie können das eigentliche Objekt NumberFormatInfo übergeben, das Formatierungsinformationen enthält. (Die Implementierung von GetFormat gibt sich selbst zurück.)

  • Sie können ein CultureInfo -Objekt übergeben, das die Kultur angibt, deren Formatierung verwendet werden soll. Die NumberFormat -Eigenschaft stellt Formatierungsinformationen zur Verfügung.

  • Sie können eine benutzerdefinierte Implementierung IFormatProvider übergeben. Die GetFormat -Methode muss das Objekt instanziieren und NumberFormatInfo zurückgeben, das Formatierungsinformationen enthält.

Wenn provider null ist, wird NumberFormatInfo das -Objekt für die aktuelle Kultur verwendet.

Siehe auch

Gilt für

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

public static ulong Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);
[System.CLSCompliant(false)]
public static ulong Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);
[System.CLSCompliant(false)]
public static ulong Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> uint64
[<System.CLSCompliant(false)>]
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> uint64
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As ULong

Parameter

s
ReadOnlySpan<Char>

Eine Zeichenspanne, die die zu konvertierende Zahl darstellt Die Zeichenspanne wird unter Verwendung des durch den style-Parameter angegebenen Stils interpretiert.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die die Stilelemente angeben, die in s vorhanden sein können. Ein häufig angegebener Wert ist Integer.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.

Gibt zurück

UInt64

Eine 64-Bit-Ganzzahl ohne Vorzeichen, die der Zahl in s entspricht.

Attribute

Gilt für

Parse(String, NumberStyles)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Decimal.Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil in die entsprechende 64-Bit-Ganzzahl ohne Vorzeichen.

public:
 static System::UInt64 Parse(System::String ^ s, System::Globalization::NumberStyles style);
[System.CLSCompliant(false)]
public static ulong Parse (string s, System.Globalization.NumberStyles style);
public static ulong Parse (string s, System.Globalization.NumberStyles style);
[<System.CLSCompliant(false)>]
static member Parse : string * System.Globalization.NumberStyles -> uint64
static member Parse : string * System.Globalization.NumberStyles -> uint64
Public Shared Function Parse (s As String, style As NumberStyles) As ULong

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt. Die Zeichenfolge wird unter Verwendung des durch den style-Parameter angegebenen Stils interpretiert.

style
NumberStyles

Eine bitweise Kombination der Enumerationswerte, die das zulässige Format von s angeben. Ein häufig angegebener Wert ist Integer.

Gibt zurück

UInt64

Eine 64-Bit-Ganzzahl ohne Vorzeichen, die der Zahl in s entspricht.

Attribute

Ausnahmen

Der s-Parameter ist null.

style ist kein NumberStyles-Wert.

- oder - style ist keine Kombination von AllowHexSpecifier- und HexNumber-Werten.

Der s-Parameter weist kein mit style kompatibles Format auf.

Der s-Parameter stellt eine Zahl dar, die kleiner als MinValue oder größer als MaxValue ist.

- oder - s enthält Dezimalstellen ungleich 0 (null).

Beispiele

Im folgenden Beispiel wird versucht, jedes Element in einem Zeichenfolgenarray mithilfe einer Reihe von Werten zu NumberStyles analysieren.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values= { " 214309 ", "1,064,181", "(0)", "10241+", " + 21499 ", 
                         " +21499 ", "122153.00", "1e03ff", "91300.0e-2" };
      NumberStyles whitespace =  NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite;
      NumberStyles[] styles= { NumberStyles.None, whitespace, 
                               NumberStyles.AllowLeadingSign | NumberStyles.AllowTrailingSign | whitespace, 
                               NumberStyles.AllowThousands | NumberStyles.AllowCurrencySymbol, 
                               NumberStyles.AllowExponent | NumberStyles.AllowDecimalPoint };

      // Attempt to convert each number using each style combination.
      foreach (string value in values)
      {
         Console.WriteLine("Attempting to convert '{0}':", value);
         foreach (NumberStyles style in styles)
         {
            try {
               ulong number = UInt64.Parse(value, style);
               Console.WriteLine("   {0}: {1}", style, number);
            }   
            catch (FormatException) {
               Console.WriteLine("   {0}: Bad Format", style);
            }   
            catch (OverflowException)
            {
               Console.WriteLine("   {0}: Overflow", value);         
            }         
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    Attempting to convert ' 214309 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: 214309
//       Integer, AllowTrailingSign: 214309
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '1,064,181':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: 1064181
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '(0)':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '10241+':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 10241
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' + 21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert ' +21499 ':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: 21499
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '122153.00':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 122153
//    
//    Attempting to convert '1e03ff':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: Bad Format
//    
//    Attempting to convert '91300.0e-2':
//       None: Bad Format
//       AllowLeadingWhite, AllowTrailingWhite: Bad Format
//       Integer, AllowTrailingSign: Bad Format
//       AllowThousands, AllowCurrencySymbol: Bad Format
//       AllowDecimalPoint, AllowExponent: 913
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { " 214309 ", "1,064,181", "(0)", "10241+", _
                                 " + 21499 ", " +21499 ", "122153.00", _
                                 "1e03ff", "91300.0e-2" }
      Dim whitespace As NumberStyles =  NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite
      Dim styles() As NumberStyles = { NumberStyles.None, _
                                       whitespace, _
                                       NumberStyles.AllowLeadingSign Or NumberStyles.AllowTrailingSign Or whitespace, _
                                       NumberStyles.AllowThousands Or NumberStyles.AllowCurrencySymbol, _
                                       NumberStyles.AllowExponent Or NumberStyles.AllowDecimalPoint }

      ' Attempt to convert each number using each style combination.
      For Each value As String In values
         Console.WriteLine("Attempting to convert '{0}':", value)
         For Each style As NumberStyles In styles
            Try
               Dim number As ULong = UInt64.Parse(value, style)
               Console.WriteLine("   {0}: {1}", style, number)
            Catch e As FormatException
               Console.WriteLine("   {0}: Bad Format", style)
            Catch e As OverflowException
               Console.WriteLine("   {0}: Overflow", value)         
            End Try         
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Attempting to convert ' 214309 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: 214309
'       Integer, AllowTrailingSign: 214309
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '1,064,181':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: 1064181
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '(0)':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '10241+':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 10241
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' + 21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert ' +21499 ':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: 21499
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '122153.00':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 122153
'    
'    Attempting to convert '1e03ff':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: Bad Format
'    
'    Attempting to convert '91300.0e-2':
'       None: Bad Format
'       AllowLeadingWhite, AllowTrailingWhite: Bad Format
'       Integer, AllowTrailingSign: Bad Format
'       AllowThousands, AllowCurrencySymbol: Bad Format
'       AllowDecimalPoint, AllowExponent: 913

Hinweise

Der -Parameter definiert die Stilelemente (z. B. Leerzeichen, das positive oder negative Vorzeichen, das Gruppentrennzeichen oder das Dezimaltrennzeichen), die im -Parameter zulässig sind, damit der Analysevorgang erfolgreich style s ist. style muss eine Kombination von Bitflags aus der -Enumeration NumberStyles sein. Der -Parameter macht diese Methodenüberladung nützlich, wenn die Zeichenfolgendarstellung eines Hexadezimalwerts enthält, wenn das zahlenweise System (dezimal oder style s hexadezimal), das durch dargestellt wird, nur zur Laufzeit bekannt ist, oder wenn Sie Leerraum oder ein Zeichensymbol in nicht zu lassen s s möchten.

Abhängig vom Wert von kann style s der -Parameter die folgenden Elemente enthalten:

[ws] [ $ ][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

Elemente in eckigen Klammern ([ und ]) sind optional. Wenn style NumberStyles.AllowHexSpecifier enthält, kann s der -Parameter die folgenden Elemente enthalten:

[ws] hexdigits[ws]

In der folgenden Tabelle wird jedes Element beschrieben.

Element Beschreibung
ws Optionaler Leerraum. Leerraum kann am Anfang von angezeigt werden, wenn das -Flag enthält, und es kann am Ende von angezeigt s style NumberStyles.AllowLeadingWhite werden, s wenn das Flag style NumberStyles.AllowTrailingWhite enthält.
$ Ein kulturspezifisches Währungssymbol. Die Position in der Zeichenfolge wird durch die Eigenschaften NumberFormatInfo.CurrencyNegativePattern und der aktuellen Kultur NumberFormatInfo.CurrencyPositivePattern definiert. Das Währungssymbol der aktuellen Kultur kann in angezeigt s werden, wenn style das Flag NumberStyles.AllowCurrencySymbol enthält.
sign Ein optionales Vorzeichen. Das Vorzeichen kann am Anfang von angezeigt werden, wenn das -Flag enthält, und es kann am Ende von angezeigt s style NumberStyles.AllowLeadingSign werden, s wenn das Flag style NumberStyles.AllowTrailingSign enthält. In können Klammern verwendet werden, s um einen negativen Wert anzugeben, wenn das Flag style NumberStyles.AllowParentheses enthält. Das negative Vorzeichensymbol kann jedoch nur mit 0 (null) verwendet werden. Andernfalls löst die -Methode eine OverflowException aus.
Zahlen

fractional_digits

exponential_digits
Eine Sequenz von Ziffern von 0 bis 9. Für fractional_digits ist nur die Ziffer 0 gültig.
, Ein kulturspezifisches Gruppentrennzeichensymbol. Das Gruppentrennzeichen der aktuellen Kultur kann in angezeigt s werden, wenn style das Flag NumberStyles.AllowThousands enthält.
. Ein kulturspezifisches Dezimaltrennzeichen. Das Dezimaltrennzeichen der aktuellen Kultur kann in angezeigt s werden, wenn style das Flag NumberStyles.AllowDecimalPoint enthält. Nur die Ziffer 0 kann als Bruchziffer angezeigt werden, damit der Analysevorgang erfolgreich ist. Wenn fractional_digits eine andere Ziffer enthält, FormatException wird eine ausgelöst.
E Das Zeichen "e" oder "E", das angibt, dass der Wert in exponentieller (wissenschaftlicher) Notation dargestellt wird. Der s -Parameter kann eine Zahl in exponentieller Notation darstellen, wenn style das Flag NumberStyles.AllowExponent enthält.
hexdigits Eine Sequenz von Hexadezimalziffern von 0 bis f oder 0 bis F.

Hinweis

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

Eine Zeichenfolge nur mit Ziffern (die dem Stil entspricht) wird immer erfolgreich analysiert, wenn sie sich im Bereich NumberStyles.None des Typs UInt64 befindet. Die meisten der verbleibenden Member steuern Elemente, die in der Eingabezeichenfolge vorhanden sein können, aber NumberStyles nicht vorhanden sein müssen. Die folgende Tabelle gibt an, wie sich NumberStyles einzelne Member auf die Elemente auswirken, die möglicherweise in vorhanden s sind.

Wert vom Typ NumberStyles Zusätzlich zu Ziffern s zulässige Elemente
None Nur das digits-Element.
AllowDecimalPoint Das Dezimaltrennzeichen (.) und Bruchziffernelemente.
AllowExponent Das Zeichen "e" oder "E", das eine exponentielle Notation angibt, zusammen mit exponential_digits.
AllowLeadingWhite Das ws-Element am Anfang von s .
AllowTrailingWhite Das ws-Element am Ende von s .
AllowLeadingSign Das Vorzeichenelement am Anfang von s .
AllowTrailingSign Das Vorzeichenelement am Ende von s .
AllowParentheses Das Vorzeichenelement in Form von Klammern, die den numerischen Wert umschließen.
AllowThousands Das Gruppentrennzeichenelement (,).
AllowCurrencySymbol Das Währungselement ($).
Currency Alle Elemente. Kann jedoch s keine Hexadezimalzahl oder eine Zahl in exponentieller Notation darstellen.
Float Das ws-Element am Anfang oder Ende von , das Zeichen am Anfang von und das Dezimaltrennzeichen s ( s .) . Der s -Parameter kann auch exponentielle Notation verwenden.
Number Die ws Elemente , , , sign Gruppentrennzeichen( , ) und Dezimaltrennzeichen (.) .
Any Alle Elemente. Kann jedoch s keine Hexadezimalzahl darstellen.

Im Gegensatz zu den anderen Werten, die das Vorhandensein bestimmter Stilelemente in zulassen, aber nicht erfordern, bedeutet der Formatwert, dass die einzelnen numerischen Zeichen in immer als NumberStyles s NumberStyles.AllowHexSpecifier s Hexadezimalzeichen interpretiert werden. Gültige Hexadezimalzeichen sind 0-9, A-F und a-f. Ein Präfix wie "0x" wird nicht unterstützt und führt dazu, dass der Analysevorgang fehlschlägt. Die einzigen anderen Flags, die mit dem -Parameter kombiniert werden style können, sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite . (Die NumberStyles -Enumeration enthält einen zusammengesetzten Zahlenstil, NumberStyles.HexNumber , der beide Leerraumflags enthält.)

Hinweis

Wenn die Zeichenfolgendarstellung einer hexadezimalen Zahl ist, kann ihr keine Verzierung (z. B. oder ) vorangehende werden, die sie als s 0x &h Hexadezimalzahl unterscheidet. Dies führt dazu, dass die Konvertierung fehlschlägt.

Der s -Parameter wird mithilfe der Formatierungsinformationen in einem -Objekt NumberFormatInfo analysiert, das für die aktuelle Systemkultur initialisiert wird. Um die Kultur anzugeben, deren Formatierungsinformationen für den Analysevorgang verwendet werden, rufen Sie die -Überladung Parse(String, NumberStyles, IFormatProvider) auf.

Siehe auch

Gilt für

Parse(String)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Decimal.Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende ganze 64-Bit-Zahl ohne Vorzeichen.

public:
 static System::UInt64 Parse(System::String ^ s);
[System.CLSCompliant(false)]
public static ulong Parse (string s);
public static ulong Parse (string s);
[<System.CLSCompliant(false)>]
static member Parse : string -> uint64
static member Parse : string -> uint64
Public Shared Function Parse (s As String) As ULong

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt.

Gibt zurück

UInt64

Eine 64-Bit-Ganzzahl ohne Vorzeichen, die der Zahl in s entspricht.

Attribute

Ausnahmen

Der s-Parameter ist null.

Der s-Parameter hat nicht das richtige Format.

Der s-Parameter stellt eine Zahl dar, die kleiner als MinValue oder größer als MaxValue ist.

Beispiele

Im folgenden Beispiel wird die Parse -Methode verwendet, um ein Array von Zeichenfolgenwerten zu analysieren.

string[] values = { "+13230", "-0", "1,390,146", "$190,235,421,127",
                    "0xFA1B", "163042", "-10", "14065839182",
                    "16e07", "134985.0", "-12034" };
foreach (string value in values)
{
   try {
      ulong number = UInt64.Parse(value); 
      Console.WriteLine("{0} --> {1}", value, number);
   }
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);   
   }  
}
// The example displays the following output:
//       +13230 --> 13230
//       -0 --> 0
//       1,390,146: Bad Format
//       $190,235,421,127: Bad Format
//       0xFA1B: Bad Format
//       163042 --> 163042
//       -10: Overflow
//       14065839182 --> 14065839182
//       16e07: Bad Format
//       134985.0: Bad Format
//       -12034: Overflow
Dim values() As String = { "+13230", "-0", "1,390,146", "$190,235,421,127", _
                           "0xFA1B", "163042", "-10", "14065839182", _
                           "16e07", "134985.0", "-12034" }
For Each value As String In values
   Try
      Dim number As ULong = UInt64.Parse(value) 
      Console.WriteLine("{0} --> {1}", value, number)
   Catch e As FormatException
      Console.WriteLine("{0}: Bad Format", value)
   Catch e As OverflowException
      Console.WriteLine("{0}: Overflow", value)   
   End Try  
Next
' The example displays the following output:
'       +13230 --> 13230
'       -0 --> 0
'       1,390,146: Bad Format
'       $190,235,421,127: Bad Format
'       0xFA1B: Bad Format
'       163042 --> 163042
'       -10: Overflow
'       14065839182 --> 14065839182
'       16e07: Bad Format
'       134985.0: Bad Format
'       -12034: Overflow

Hinweise

Der s Parameter sollte die Zeichenfolgendarstellung einer Zahl im folgenden Format sein.

[ws] [Signieren] digits[ws]

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

Element Beschreibung
ws Optionaler Leerraum.
sign Ein optionales Zeichen. Gültige Vorzeichen werden durch die NumberFormatInfo.NegativeSign Eigenschaften und NumberFormatInfo.PositiveSign der aktuellen Kultur bestimmt. Das negative Vorzeichen kann jedoch nur mit 0 (null) verwendet werden. Andernfalls löst die -Methode eine OverflowException aus.
Zahlen Eine Sequenz von Ziffern im Bereich von 0 bis 9. Alle führenden Nullen werden ignoriert.

Hinweis

Die vom -Parameter angegebene s Zeichenfolge wird mithilfe des -Stils NumberStyles.Integer interpretiert. Er darf keine Gruppentrennzeichen oder Dezimaltrennzeichen enthalten und darf keinen Dezimalteil enthalten.

Der s -Parameter wird mithilfe der Formatierungsinformationen in einem -Objekt System.Globalization.NumberFormatInfo analysiert, das für die aktuelle Systemkultur initialisiert wird. Weitere Informationen finden Sie unter NumberFormatInfo.CurrentInfo. Um eine Zeichenfolge mithilfe der Formatierungsinformationen einer bestimmten Kultur zu analysieren, verwenden Sie die Parse(String, IFormatProvider) -Methode.

Siehe auch

Gilt für

Parse(String, IFormatProvider)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Decimal.Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in die entsprechende ganze 64-Bit-Zahl ohne Vorzeichen.

public:
 static System::UInt64 Parse(System::String ^ s, IFormatProvider ^ provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, IFormatProvider provider);
public static ulong Parse (string s, IFormatProvider? provider);
[System.CLSCompliant(false)]
public static ulong Parse (string s, IFormatProvider? provider);
[<System.CLSCompliant(false)>]
static member Parse : string * IFormatProvider -> uint64
static member Parse : string * IFormatProvider -> uint64
Public Shared Function Parse (s As String, provider As IFormatProvider) As ULong

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.

Gibt zurück

UInt64

Eine 64-Bit-Ganzzahl ohne Vorzeichen, die der Zahl in s entspricht.

Attribute

Ausnahmen

Der s-Parameter ist null.

Der s-Parameter hat nicht das richtige Format.

Der s-Parameter stellt eine Zahl dar, die kleiner als MinValue oder größer als MaxValue ist.

Beispiele

Das folgende Beispiel ist der Schaltflächenklick-Ereignishandler eines Webformulars. Es verwendet das von der HttpRequest.UserLanguages -Eigenschaft zurückgegebene Array, um das Gebietsschema des Benutzers zu bestimmen. Anschließend wird ein CultureInfo -Objekt instanziiert, das diesem Gebietsschema entspricht. Das NumberFormatInfo Objekt, das zu diesem Objekt gehört, CultureInfo wird dann an die Parse(String, IFormatProvider) -Methode übergeben, um die Eingabe des Benutzers in einen Wert zu UInt64 konvertieren.

protected void OkToSingle_Click(object sender, EventArgs e)
{
   string locale;
   float number;
   CultureInfo culture;

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return;

   // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);

   // Convert user input from a string to a number
   try
   {
      number = Single.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToSingle_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToSingle.Click
   Dim locale As String
   Dim culture As CultureInfo
   Dim number As Single

   ' Return if string is empty
   If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub

   ' Get locale of web request to determine possible format of number
   If Request.UserLanguages.Length = 0 Then Exit Sub
   locale = Request.UserLanguages(0)
   If String.IsNullOrEmpty(locale) Then Exit Sub

   ' Instantiate CultureInfo object for the user's locale
   culture = New CultureInfo(locale)

   ' Convert user input from a string to a number
   Try
      number = Single.Parse(Me.inputNumber.Text, culture.NumberFormat)
   Catch ex As FormatException
      Exit Sub
   Catch ex As OverflowException
      Exit Sub
   End Try

   ' Output number to label on web form
   Me.outputNumber.Text = "Number is " & number.ToString()
End Sub

Hinweise

Diese Überladung der -Methode wird in der Parse(String, IFormatProvider) Regel verwendet, um Text zu konvertieren, der auf verschiedene Weise in einen Wert formatiert werden UInt64 kann. 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 enthält eine Nummer des Formulars:

[ws] [Vorzeichen]Ziffern[ws]

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

Element Beschreibung
ws Optionaler Leerraum.
sign Ein optionales positives Zeichen oder ein negatives Vorzeichen, wenn s den Wert 0 (null) darstellt.
Zahlen Eine Sequenz von Ziffern im Bereich von 0 bis 9.

Der s-Parameter wird mithilfe des NumberStyles.Integer Stils interpretiert. Zusätzlich zu den Dezimalstellen des ganzzahligen Werts ohne Vorzeichen sind nur führende und nachfolgende Leerzeichen zusammen mit einem führenden Vorzeichen zulässig. (Wenn das negative Vorzeichen vorhanden ist, s muss den Wert 0 (null) darstellen, oder die Methode löst eine OverflowException aus.) Verwenden Sie die -Methode, um die Stilelemente zusammen mit den kulturspezifischen Formatierungsinformationen, die in vorhanden sein können, explizit zu s Parse(String, NumberStyles, IFormatProvider) definieren.

Der provider -Parameter ist eine IFormatProvider Implementierung, deren GetFormat -Methode ein NumberFormatInfo -Objekt zurückgibt, das kulturspezifische Informationen zum Format von s bereitstellt. Es gibt drei Möglichkeiten, den provider -Parameter zum Bereitstellen von benutzerdefinierten Formatierungsinformationen für den Analysevorgang zu verwenden:

  • Sie können das eigentliche NumberFormatInfo Objekt übergeben, das Formatierungsinformationen bereitstellt. (Die Implementierung von GetFormat gibt sich einfach selbst zurück.)

  • Sie können ein CultureInfo -Objekt übergeben, das die Kultur angibt, deren Formatierung verwendet werden soll. Die NumberFormat -Eigenschaft stellt Formatierungsinformationen bereit.

  • Sie können eine benutzerdefinierte IFormatProvider Implementierung übergeben. Die GetFormat -Methode muss das -Objekt instanziieren und NumberFormatInfo zurückgeben, das Formatierungsinformationen bereitstellt.

Wenn provider null ist, NumberFormatInfo wird für die aktuelle Kultur verwendet.

Siehe auch

Gilt für