UInt16.TryParse Methode

Definition

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende ganze 16-Bit-Zahl ohne Vorzeichen.Converts the string representation of a number to its 16-bit unsigned integer equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

Überlädt

TryParse(String, UInt16)

Versucht, die Zeichenfolgendarstellung einer Zahl in die entsprechende 16-Bit-Ganzzahl ohne Vorzeichen zu konvertieren.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt16)
TryParse(String, NumberStyles, IFormatProvider, UInt16)

Versucht, die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 16-Bit-Ganzzahl ohne Vorzeichen zu konvertieren.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

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

TryParse(String, UInt16)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Int32.TryParse(String, Int32)

Versucht, die Zeichenfolgendarstellung einer Zahl in die entsprechende 16-Bit-Ganzzahl ohne Vorzeichen zu konvertieren.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out ushort result);
static member TryParse : string * uint16 -> bool
Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt.A string that represents the number to convert.

result
UInt16

Diese Methode gibt bei erfolgreicher Konvertierung den ganzen 16-Bit-Zahlwert ohne Vorzeichen zurück, der der Zahl in s entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte.When this method returns, contains the 16-bit unsigned integer value that is equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. Die Konvertierung schlägt fehl, wenn der s-Parameter null oder Empty ist oder nicht im korrekten Format vorliegt.The conversion fails if the s parameter is null or Empty, is not in the correct format. oder eine Zahl darstellt, die kleiner als MinValue oder größer als MaxValue ist., or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

Attribute

Beispiele

Im folgenden Beispiel wird die TryParse(String, UInt16) -Methode einmal für jedes Element in einem Zeichen folgen Array aufgerufen.The following example calls the TryParse(String, UInt16) method once for each element in a string array.

string[] numericStrings = { "1293.8", "+1671.7", "28347.",  
                            "   33113684  ", "(0)", "-0", "-1", 
                            "+1293617", "18-", "119870", "31,024", 
                            "  3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
   if (UInt32.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt32.
//       Cannot convert '+1671.7' to a UInt32.
//       Cannot convert '28347.' to a UInt32.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt32.
//       Converted '-0' to 0.
//       Cannot convert '-1' to a UInt32.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt32.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt32.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", 
                                  "   33113684  ", "(0)", "-0", "-1",
                                  "+1293617", "18-", "119870", 
                                  "31,024", "  3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
   If UInt32.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt32.
'       Cannot convert '+1671.7' to a UInt32.
'       Cannot convert '28347.' to a UInt32.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt32.
'       Converted '-0' to 0.
'       Cannot convert '-1' to a UInt32.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt32.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt32.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

Hinweise

Die TryParse(String, UInt16) -Methode ähnelt der Parse(String) -Methode, mit der Ausnahme, dass keine Ausnahme ausgelöst wird, wenn bei der Konvertierung ein Fehler auftritt.The TryParse(String, UInt16) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. Mit dieser Methode entfällt die Notwendigkeit, die Ausnahmebehandlung zum Testen auf FormatException einen s zu verwenden, wenn ungültig ist und nicht erfolgreich analysiert werden kann.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be successfully parsed.

Der s -Parameter sollte die Zeichen folgen Darstellung einer Dezimalzahl in der folgenden Form sein:The s parameter should be the string representation of a decimal number in the following form:

[WS] [Sign] Ziffern [WS][ws][sign]digits[ws]

Elemente in eckigen Klammern ([ und ]) sind optional.Elements in square brackets ([ and ]) are optional. In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element.

ElementElement BeschreibungDescription
wsws Optionaler Leerraum.Optional white space.
signsign Ein optionales Vorzeichen.An optional sign. Gültige Zeichen werden von der NumberFormatInfo.NegativeSign -Eigenschaft und der- NumberFormatInfo.PositiveSign Eigenschaft der aktuellen Kultur bestimmt.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
Zifferndigits Eine Sequenz von Dezimalziffern im Bereich von 0 bis 9.A sequence of decimal digits ranging from 0 to 9.

Hinweis

Die vom s -Parameter angegebene Zeichenfolge darf keine Gruppen Trennzeichen oder Dezimaltrennzeichen enthalten, und Sie darf keinen Dezimalteil enthalten.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Der s -Parameter wird mit dem NumberStyles.Integer -Stil interpretiert.The s parameter is interpreted by using the NumberStyles.Integer style. Zusätzlich zu den Dezimalziffern sind nur führende und nachfolgende Leerzeichen mit einem vorangestellten Zeichen zulässig.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Um die Stilelemente mit den kulturspezifischen Formatierungsinformationen, die in svorhanden sein können, explizit zu definieren, müssen Sie die TryParse(String, NumberStyles, IFormatProvider, UInt16) -Methode aufzurufen.To explicitly define the style elements with the culture-specific formatting information that can be present in s, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) method.

Der s -Parameter wird analysiert, indem die Formatierungsinformationen in NumberFormatInfo einem-Objekt für die aktuelle System Kultur verwendet werden.The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. Weitere Informationen finden Sie unter NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

Diese Überladung interpretiert alle Ziffern im s -Parameter als Dezimalziffern.This overload interprets all digits in the s parameter as decimal digits. Um die Zeichen folgen Darstellung einer hexadezimalen Zahl zu analysieren, müssen TryParse(String, NumberStyles, IFormatProvider, UInt16) Sie stattdessen die-Überladung aufrufen.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) overload instead.

Siehe auch

TryParse(ReadOnlySpan<Char>, UInt16)

Wichtig

Diese API ist nicht CLS-kompatibel.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ushort result);
static member TryParse : ReadOnlySpan<char> * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UShort) As Boolean

Parameter

result
UInt16

Gibt zurück

Attribute

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Int32.TryParse(String, Int32)

Versucht, die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 16-Bit-Ganzzahl ohne Vorzeichen zu konvertieren.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.A return value indicates whether the conversion succeeded or failed.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parameter

s
String

Eine Zeichenfolge, die die zu konvertierende Zahl darstellt.A string that represents the number to convert. Die Zeichenfolge wird unter Verwendung des durch den style-Parameter angegebenen Stils interpretiert.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles

Eine bitweise Kombination von Enumerationswerten, die das zulässige Format von s angibt.A bitwise combination of enumeration values that indicates the permitted format of s. Ein häufig angegebener Wert ist Integer.A typical value to specify is Integer.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen zu s bereitstellt.An object that supplies culture-specific formatting information about s.

result
UInt16

Diese Methode gibt bei erfolgreicher Konvertierung den 16-Bit-Ganzzahlwert ohne Vorzeichen zurück, der der Zahl in s entspricht, und 0 (null), wenn die Konvertierung nicht durchgeführt werden konnte.When this method returns, contains the 16-bit unsigned integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. Bei der Konvertierung tritt ein Fehler auf, wenn der s-Parameter null oder Empty ist, nicht in einem mit style kompatiblen Format vorliegt oder eine Zahl kleiner als MinValue oder größer als MaxValue darstellt.The conversion fails if the s parameter is null or Empty, is not in a format compliant with style, or represents a number less than MinValue or greater than MaxValue. Dieser Parameter wird nicht initialisiert übergeben. Jeder Wert, der ursprünglich im bereitgestellten result überschrieben werden.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Gibt zurück

true, wenn s erfolgreich konvertiert wurde, andernfalls false.true if s was converted successfully; otherwise, false.

Attribute

Ausnahmen

style ist kein NumberStyles-Wert.style is not a NumberStyles value.

- oder --or- style ist keine Kombination von AllowHexSpecifier- und HexNumber-Werten.style is not a combination of AllowHexSpecifier and HexNumber values.

Beispiele

Im folgenden Beispiel wird die TryParse(String, NumberStyles, IFormatProvider, UInt16) -Methode mit einer Reihe von unterschiedlichen NumberStyles Zeichen folgen und Werten aufgerufen.The following example calls the TryParse(String, NumberStyles, IFormatProvider, UInt16) method with a number of different strings and NumberStyles values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "10603";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-10603";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "29103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "2210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ushort number;
      bool result = UInt16.TryParse(stringToConvert, styles, 
                                   CultureInfo.InvariantCulture, out number);
      if (result)
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
      else
         Console.WriteLine("Attempted conversion of '{0}' failed.", 
                           Convert.ToString(stringToConvert));
   }
}
// The example displays the following output:
//       Converted '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10603"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "2210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UShort
      Dim result As Boolean = UInt16.TryParse(stringToConvert, styles, _
                                              CultureInfo.InvariantCulture, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
      Else
         Console.WriteLine("Attempted conversion of '{0}' failed.", _
                           Convert.ToString(stringToConvert))
      End If                                                                           
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '10603' to 10603.
'       Attempted conversion of '-10603' failed.
'       Converted '29103.00' to 29103.
'       Attempted conversion of '10345.72' failed.
'       Converted '2210E-01' to 221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC8' to 65480.
'       Attempted conversion of '0x8F8C' failed.

Hinweise

Die TryParse(String, NumberStyles, IFormatProvider, UInt16) -Methode ähnelt der Parse(String, NumberStyles, IFormatProvider) -Methode, mit der Ausnahme, dass keine Ausnahme ausgelöst wird, wenn bei der Konvertierung ein Fehler auftritt.The TryParse(String, NumberStyles, IFormatProvider, UInt16) method is like the Parse(String, NumberStyles, IFormatProvider) method, except that it does not throw an exception if the conversion fails. Mit dieser Methode entfällt die Notwendigkeit, die Ausnahmebehandlung zum Testen auf FormatException einen s zu verwenden, wenn ungültig ist und nicht erfolgreich analysiert werden kann.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

Der style -Parameter definiert die Stilelemente (z. b. Leerzeichen oder ein positives oder negatives Zeichen), die s im-Parameter zulässig sind, damit der Analyse Vorgang erfolgreich ausgeführt werden kann.The style parameter defines the style elements (such as white space or a positive or negative sign) that are allowed in the s parameter for the parse operation to succeed. Dabei muss es sich um eine Kombination von Bitflags aus der NumberStyles -Enumeration handeln.It must be a combination of bit flags from the NumberStyles enumeration. Abhängig vom Wert von stylekann der s -Parameter die folgenden Elemente enthalten:Depending on the value of style, the s parameter may include the following elements:

[WS] [$] [Sign] [digits,]digits[. fractional_digits] [E [Sign]Exponential_digits] [WS][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

Elemente in eckigen Klammern ([und]) sind optional.Items in square brackets ([ and ]) are optional. Wenn der style -Parameter enthält AllowHexSpecifier, kann der s -Parameter die folgenden Elemente enthalten:Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

[WS] Hexziffern [WS][ws]hexdigits[ws]

In der folgenden Tabelle wird jedes Element beschrieben.The following table describes each element.

wsws
Optionaler Leerraum.Optional white space. Leerraum kann am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingWhite -Flag enthält, oder am Ende s von style , wenn NumberStyles.AllowTrailingWhite das-Flag enthält.White space can appear at the start of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.

$
Ein kulturspezifisches Währungssymbol.A culture-specific currency symbol. Die Position in der Zeichenfolge wird durch die CurrencyPositivePattern -Eigenschaft NumberFormatInfo des-Objekts definiert, GetFormat das provider von der-Methode des-Parameters zurückgegeben wird.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Das Währungssymbol kann in s angezeigt werden, wenn NumberStyles.AllowCurrencySymbol style das-Flag enthält.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
Ein optionales Vorzeichen.An optional sign. Das Vorzeichen kann am Anfang von s angezeigt werden, wenn style das NumberStyles.AllowLeadingSign -Flag enthält, und es kann am Ende von s angezeigt style werden, NumberStyles.AllowTrailingSign wenn das-Flag enthält.The sign can appear at the start of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Klammern können in s verwendet werden, um einen negativen Wert anzugeben, wenn style das NumberStyles.AllowParentheses -Flag einschließt.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Wenn jedoch das negative Vorzeichen vorhanden ist, kann s nur den Wert 0 (null) darstellen, damit der Analyse Vorgang erfolgreich ausgeführt werden kann.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.

Zifferndigits
Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits from 0 through 9.

,,
Ein kulturspezifisches Gruppen Trennzeichen.A culture-specific group separator. Das Gruppen Trennzeichen der Kultur, die provider von angegeben wird s , style kann in NumberStyles.AllowThousands angezeigt werden, wenn das-Flag enthält.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.

..
Ein kulturspezifisches Dezimaltrennzeichen.A culture-specific decimal point symbol. Das Dezimaltrennzeichen der Kultur, die von provider angegeben wird, s kann style in angezeigt NumberStyles.AllowDecimalPoint werden, wenn das-Flag enthält.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.

fractional_digitsfractional_digits
Mindestens ein Vorkommen der Ziffer 0 (null).One or more occurrences of the digit 0. Bruch Ziffern können nur in s vorkommen, wenn style das NumberStyles.AllowDecimalPoint -Flag enthält.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.

EE
Das Zeichen "e" oder "e", das angibt, dass der Wert in exponentieller Notation (Scientific) dargestellt wird.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Der s -Parameter kann eine Zahl in Exponentialnotation style darstellen, NumberStyles.AllowExponent wenn das-Flag enthält.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

exponential_digitsexponential_digits
Eine Sequenz von Ziffern zwischen 0 und 9.A sequence of digits from 0 through 9. Der s -Parameter kann eine Zahl in Exponentialnotation style darstellen, NumberStyles.AllowExponent wenn das-Flag enthält.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

Hexziffernhexdigits
Eine Sequenz von hexadezimalen Ziffern zwischen 0 und f oder 0 bis f.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Hinweis

Alle abschließenden NUL-Zeichen (U + 0000) s in werden vom Analyse-Vorgang unabhängig vom Wert style des Arguments ignoriert.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Eine Zeichenfolge mit nur Dezimalziffern (die dem NumberStyles.None -Flag entspricht) wird immer erfolgreich analysiert.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Die meisten der Verb NumberStyles leibenden Member steuern Elemente, die in dieser Eingabe Zeichenfolge vorhanden sein können, aber nicht vorhanden sein müssen.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. In der folgenden Tabelle wird angegeben NumberStyles , wie sich einzelne Member auf die Elemente auswirken s, die in vorhanden sein können.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Nicht zusammengesetzte NumberStyles WerteNon-composite NumberStyles values Als Wert zulässige Elemente zusätzlich zu ZiffernElements permitted in value in addition to digits
None Nur Dezimalziffern.Decimal digits only.
AllowDecimalPoint Die Dezimaltrennzeichen (.) und fractional_digits Elemente.The decimal point (.) and fractional_digits elements. Fractional_digits muss jedoch nur aus einer oder mehreren 0 Ziffern bestehen, oder die Methode gibt zurück false.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Das Zeichen "e" oder "e", das die Exponentialnotation angibt, zusammen mit Exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Wenn s eine Zahl in Exponentialnotation darstellt, kann Sie keine Bruchteil-Komponente ungleich 0 (null) aufweisen.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Das WS -Element am Anfang von s.The ws element at the start of s.
AllowTrailingWhite Das WS -Element am Ende von s.The ws element at the end of s.
AllowLeadingSign Das Vorzeichen Element vor Ziffern.The sign element before digits.
AllowTrailingSign Das Sign -Element nach Ziffern.The sign element after digits.
AllowParentheses Das Vorzeichen Element in Form von Klammern, das einen numerischen Wert von 0 (null) einschließt.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Das Gruppen Trennzeichen (,).The group separator (,) element.
AllowCurrencySymbol Das Currency ($)-Element.The currency ($) element.
Currency Alle-Elemente.All elements. Es ist s jedoch nicht möglich, eine hexadezimale Zahl oder eine Zahl in Exponentialnotation darzustellen.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Das WS -Element am Anfang oder Ende von s, Signieren Sie am Anfang svon und das Dezimaltrennzeichen (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Der s -Parameter kann auch die Exponentialnotation verwenden.The s parameter can also use exponential notation.
Number Die Elemente WS, Sign, Group Separator (,) und Decimal Point (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Alle-Elemente.All elements. Eine hexadezimale Zahl kann jedoch nicht dargestellt werden s .However, s cannot represent a hexadecimal number.

Wenn das NumberStyles.AllowHexSpecifier -Flag verwendet wird s , muss ein Hexadezimalwert sein.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Gültige hexadezimale Ziffern sind 0 bis 9, a bis f und a bis f. Ein Präfix, z. b. "0x", wird nicht unterstützt und bewirkt, dass der Analyse Vorgang fehlschlägt.Valid hexadecimal digits are 0 through 9, a through f, and A through F. A prefix such as "0x" is not supported and causes the parse operation to fail. Die einzigen anderen Flags, die in style vorhanden sein können, sind NumberStyles.AllowLeadingWhite und NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Die NumberStyles -Enumeration verfügt über einen zusammen HexNumbergesetzten Stil,, der beide Leerzeichen enthält.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Hinweis

Wenn s die Zeichen folgen Darstellung einer hexadezimalen Zahl ist, kann Ihr keine Ergänzung ( 0x z. b. oder &h) vorangestellt werden, die Sie als hexadezimale Zahl unterscheidet.If s is the string representation of a hexadecimal number, it cannot be preceded by any decoration (such as 0x or &h) that differentiates it as a hexadecimal number. Dies bewirkt, dass die Konvertierung fehlschlägt.This causes the conversion to fail.

Der provider -Parameter ist IFormatProvider eine-Implementierung.The provider parameter is an IFormatProvider implementation. Die zugehörige- NumberFormatInfo sMethode gibt ein-Objekt zurück, das kulturspezifische Informationen zum Format von bereitstellt. GetFormatIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Der provider Parameter kann eine der folgenden sein:The provider parameter can be any one of the following:

  • Ein CultureInfo -Objekt, das die Kultur darstellt, die Formatierungsinformationen bereitstellt.A CultureInfo object that represents the culture that supplies formatting information. NumberFormatInfo Die- GetFormat Methode gibt das-Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Ein NumberFormatInfo -Objekt, das numerische Formatierungsinformationen bereitstellt.A NumberFormatInfo object that provides numeric formatting information. (Die Implementierung von GetFormat gibt nur sich selbst zurück.)(Its implementation of GetFormat just returns itself.)

  • Ein benutzerdefiniertes Objekt IFormatProvider, das implementiert.A custom object that implements IFormatProvider. Die- NumberFormatInfo Methode instanziiert und gibt das Objekt zurück, das Formatierungsinformationen bereitstellt. GetFormatIts GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Wenn providerden Wert NumberFormatInfo hat, wird das-Objekt für die aktuelle Kultur verwendet. nullIf provider is null, the NumberFormatInfo object for the current culture is used.

Siehe auch

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

Wichtig

Diese API ist nicht CLS-kompatibel.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parameter

style
NumberStyles
provider
IFormatProvider
result
UInt16

Gibt zurück

Attribute

Gilt für: