UInt16.TryParse UInt16.TryParse UInt16.TryParse UInt16.TryParse Method

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) TryParse(String, UInt16) TryParse(String, UInt16) 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(ReadOnlySpan<Char>, UInt16) TryParse(ReadOnlySpan<Char>, UInt16) TryParse(ReadOnlySpan<Char>, UInt16)
TryParse(String, NumberStyles, IFormatProvider, UInt16) TryParse(String, NumberStyles, IFormatProvider, UInt16) TryParse(String, NumberStyles, IFormatProvider, 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(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16)

TryParse(String, UInt16) TryParse(String, UInt16) TryParse(String, 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 *  -> bool
Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean

Parameter

s
String String String String

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

result
UInt16 UInt16 UInt16 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.

Beispiele

Im folgenden Beispiel wird die TryParse(String, UInt16) Methode einmal für jedes Element in einem Zeichenfolgenarray.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 entspricht der Parse(String) -Methode, mit dem Unterschied, dass die It keine Ausnahme auslöst, wenn die Konvertierung schlägt fehl.The TryParse(String, UInt16) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. Diese Methode entfällt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um das Testen einer FormatException Wenn s ist ungültig und kann 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.

Die s Parameter sollte die Zeichenfolgendarstellung einer ganzen Zahl in der folgenden Form sein:The s parameter should be the string representation of a decimal number in the following form:

[ws][sign]digits[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 Beschreibung Description
wsws Optionalen Leerzeichen.Optional white space.
signsign Einem optionalen Vorzeichen.An optional sign. Gültige Zeichen für Vorzeichen hängen von der NumberFormatInfo.NegativeSign und NumberFormatInfo.PositiveSign Eigenschaften der aktuellen Kultur.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
Zifferndigits Eine Sequenz von Dezimalziffern, die im Bereich von 0 bis 9.A sequence of decimal digits ranging from 0 to 9.

Hinweis

Die Zeichenfolge, die gemäß der s Parameter darf nicht keine Gruppentrennzeichen oder ein Dezimaltrennzeichen enthalten, und es sind keine Dezimalstellen.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Die s Parameter wird interpretiert, mit der NumberStyles.Integer Stil.The s parameter is interpreted by using the NumberStyles.Integer style. Neben der Dezimalstelle dürfen nur führende und nachfolgende Leerzeichen mit einem vorangestellten Plus-oder Minuszeichen.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Die Stilelemente mit der kulturspezifischen Formatierungsinformationen explizit zu definieren, die in vorhanden sein können s, rufen Sie die TryParse(String, NumberStyles, IFormatProvider, UInt16) Methode.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.

Die s Parameter analysiert wird, mithilfe den Formatierungsinformationen in eine NumberFormatInfo -Objekt für die aktuelle Systemkultur.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 in der s Parameter als Dezimalzahlen.This overload interprets all digits in the s parameter as decimal digits. Um die angegebene Zeichenfolgendarstellung einer Hexadezimalzahl analysieren möchten, rufen Sie die TryParse(String, NumberStyles, IFormatProvider, UInt16) stattdessen die Überladung.To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) overload instead.

Siehe auch

TryParse(ReadOnlySpan<Char>, UInt16) TryParse(ReadOnlySpan<Char>, UInt16) TryParse(ReadOnlySpan<Char>, UInt16) 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> *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UShort) As Boolean

Parameter

Gibt zurück

TryParse(String, NumberStyles, IFormatProvider, UInt16) TryParse(String, NumberStyles, IFormatProvider, UInt16) TryParse(String, NumberStyles, IFormatProvider, UInt16) 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 *  -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parameter

s
String String String 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 NumberStyles NumberStyles 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 IFormatProvider IFormatProvider IFormatProvider

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

result
UInt16 UInt16 UInt16 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.

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 verschiedenen Zeichenfolgen und NumberStyles Werte.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 entspricht der Parse(String, NumberStyles, IFormatProvider) -Methode, mit dem Unterschied, dass die It keine Ausnahme auslöst, wenn die Konvertierung schlägt fehl.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. Diese Methode entfällt die Notwendigkeit, die Ausnahmebehandlung zu verwenden, um das Testen einer FormatException Wenn s ist ungültig und kann nicht erfolgreich analysiert werden.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

Die style Parameter definiert die Stilelemente (z.B. Leerzeichen oder ein positiven oder negativen Vorzeichen), die in dürfen die s Parameter, damit der Analysevorgang erfolgreich ist.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. Es muss eine Kombination von Bitflags aus den NumberStyles Enumeration.It must be a combination of bit flags from the NumberStyles enumeration. Abhängig vom Wert style, 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. Oder, wenn Sie die style Parameter enthält AllowHexSpecifier, s Parameter die folgenden Elemente enthalten:Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

[ws]hexdigits[ws][ws]hexdigits[ws]

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

wsws
Optionalen Leerzeichen.Optional white space. Leerzeichen am Anfang stehen s Wenn style enthält die NumberStyles.AllowLeadingWhite Flag oder am Ende der s Wenn style enthält die NumberStyles.AllowTrailingWhite Flag.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.

$
Eine kulturspezifische Währungssymbol.A culture-specific currency symbol. Seine Position in der Zeichenfolge wird definiert, durch die CurrencyPositivePattern Eigenschaft der NumberFormatInfo zurückgegebenes Objekt der GetFormat -Methode der der provider Parameter.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 angezeigt werden kann, im s Wenn style enthält die NumberStyles.AllowCurrencySymbol Flag.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
Einem optionalen Vorzeichen.An optional sign. Die Zeichen am Anfang stehen s Wenn style enthält die NumberStyles.AllowLeadingSign Flag, und es können angezeigt werden, am Ende der s Wenn style enthält die NumberStyles.AllowTrailingSign Flag.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 verwendet werden, s um einen negativen Wert anzugeben, ob style enthält die NumberStyles.AllowParentheses Flag.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Aber wenn die negativen Vorzeichen vorhanden ist, s können nur den Wert 0 (null), damit der Analysevorgang erfolgreich darstellen.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.

Zifferndigits
Eine Folge von Ziffern von 0 bis 9.A sequence of digits from 0 through 9.

,,
Eine kulturspezifische Gruppentrennzeichen.A culture-specific group separator. Das Gruppentrennzeichen von der durch den angegebenen Kultur provider stehen s Wenn style enthält die NumberStyles.AllowThousands Flag.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.

..
Eine kulturspezifische Dezimaltrennzeichen.A culture-specific decimal point symbol. Das Dezimaltrennzeichen von der durch den angegebenen Kultur provider stehen s Wenn style enthält die NumberStyles.AllowDecimalPoint Flag.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.

fractional_digitsfractional_digits
Ein oder mehrere Vorkommen der Ziffer 0.One or more occurrences of the digit 0. Bruchziffern können angezeigt werden, s nur, wenn style enthält die NumberStyles.AllowDecimalPoint Flag.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.

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

exponential_digitsexponential_digits
Eine Folge von Ziffern von 0 bis 9.A sequence of digits from 0 through 9. Die s Parameter kann eine Zahl in Exponentialschreibweise darstellen, wenn style enthält die NumberStyles.AllowExponent Flag.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

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

Hinweis

Alle abschließenden NULL (U + 0000)-Zeichen im s werden ignoriert, durch den Analysevorgang, unabhängig vom Wert für die style Argument.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 Dezimalstellen (Dies entspricht der NumberStyles.None Flag) immer erfolgreich analysiert.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Die meisten der verbleibenden NumberStyles Member steuern Elemente, die möglicherweise vorhanden, jedoch müssen nicht in dieser Eingabezeichenfolge vorhanden sein.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. Die folgende Tabelle gibt an, wie einzelne NumberStyles Mitglieder Auswirkungen auf die Elemente, die ggf. im s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Nicht zusammengesetzte NumberStyles WerteNon-composite NumberStyles values Elemente in den Wert neben Ziffern zulässig sindElements permitted in value in addition to digits
None Nur Dezimalstellen.Decimal digits only.
AllowDecimalPoint Das Dezimaltrennzeichen (.) und Bruchziffern Elemente.The decimal point (.) and fractional_digits elements. Allerdings Bruchziffern müssen bestehen aus nur einer oder mehreren 0-Ziffern oder der Rückgabe der Methode false.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Das "e" oder "E"-Zeichen, womit Exponentialschreibweise, zusammen mit Exponenten-Ziffern.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Wenn s steht für eine Zahl in Exponentialschreibweise, er darf keine Komponente nicht 0 (null) werden die Dezimalstellen.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Die ws Element am Anfang des s.The ws element at the start of s.
AllowTrailingWhite Die ws Element am Ende der s.The ws element at the end of s.
AllowLeadingSign Die anmelden vor Element Ziffern.The sign element before digits.
AllowTrailingSign Die anmelden Element an, nach Ziffern.The sign element after digits.
AllowParentheses Die anmelden Element in Form von Klammern, numerischen Wert 0 (null) einschließen.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Das Gruppentrennzeichen (,) Element.The group separator (,) element.
AllowCurrencySymbol Die Währung ($) Element.The currency ($) element.
Currency Alle Elemente.All elements. Allerdings s keine hexadezimale Zahl oder eine Zahl in Exponentialschreibweise darstellen.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Die ws Element am Anfang oder Ende des s, anmelden am Anfang des s, und dem Dezimaltrennzeichen an (.) Symbol.The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Die s Parameter können Sie auch Exponentialschreibweise.The s parameter can also use exponential notation.
Number Die ws, anmelden, Gruppentrennzeichen (,), und ein Dezimaltrennzeichen (.) Elemente.The ws, sign, group separator (,), and decimal point (.) elements.
Any Alle Elemente.All elements. Allerdings s eine hexadezimale Zahl nicht darstellen kann.However, s cannot represent a hexadecimal number.

Wenn die NumberStyles.AllowHexSpecifier -Flag wird verwendet, s muss ein hexadezimaler Wert 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 wie "0 X" wird nicht unterstützt und führt dazu, dass den Analysevorgang 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 vorhanden sein können style 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 ein zusammengesetztes Format, HexNumber, die sowohl Leerraumzeichen-Flags enthält.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Hinweis

Wenn s ist die Zeichenfolgendarstellung des eine hexadezimale Zahl ist, es kann nicht vorangestellt werden Dekoration (z. B. 0x oder &h) unterscheidet, die sie als hexadezimale Zahl.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.

Die provider -Parameter ist ein IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat Methode gibt eine NumberFormatInfo -Objekt, das kulturspezifische Informationen zum Format von bietet s.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Die provider Parameter kann eine der folgenden sein:The provider parameter can be any one of the following:

  • Ein CultureInfo -Objekt, das die Kultur darstellt, das Formatierungsinformationen bereitstellt.A CultureInfo object that represents the culture that supplies formatting information. Die GetFormat Methode gibt die NumberFormatInfo -Objekt, das numerische Formatierungsinformationen für die jeweilige 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. (Eine Implementierung von GetFormat nur sich selbst zurückgibt.)(Its implementation of GetFormat just returns itself.)

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

Wenn provider ist null, NumberFormatInfo -Objekt für die aktuelle Kultur verwendet.If provider is null, the NumberFormatInfo object for the current culture is used.

Siehe auch

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) 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 *  -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean

Parameter

Gibt zurück

Gilt für: