UInt16.TryParse Metoda

Definicja

Konwertuje ciąg reprezentujący liczbę na odpowiadającą mu 16-bitową liczbę całkowitą bez znaku.Converts the string representation of a number to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

Przeciążenia

TryParse(String, UInt16)

Próbuje przekonwertować ciąg reprezentujący liczbę na odpowiadającą jej 16-bitową liczbę całkowitą bez znaku.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt16)

Próbuje skonwertować reprezentację zakresu liczby na jej odpowiednik 16-bitową liczbą całkowitą bez znaku.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Próbuje przekonwertować ciąg reprezentujący liczbę w określonym stylu i formacie specyficznym dla kultury na jego 16-bitową liczbę całkowitą bez znaku.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

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

Próbuje skonwertować reprezentację zakresu liczby w określonym stylu i formacie specyficznym dla kultury na odpowiadającą jej 16-bitową liczbę całkowitą bez znaku.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

TryParse(String, UInt16)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Alternatywa zgodna ze specyfikacją CLS
System.Int32.TryParse(String, Int32)

Próbuje przekonwertować ciąg reprezentujący liczbę na odpowiadającą jej 16-bitową liczbę całkowitą bez znaku.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.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

Parametry

s
String

Ciąg reprezentujący liczbę, którą należy przekształcić.A string that represents the number to convert.

result
UInt16

Gdy ta metoda zwraca, zawiera 16-bitową liczbę całkowitą bez znaku, która jest równoważna liczbie zawartej w s, jeśli konwersja zakończyła się powodzeniem lub zero, jeśli konwersja nie powiodła się.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. Konwersja nie powiedzie się, jeśli parametr s jest null lub Empty, nie ma poprawnego formatu.The conversion fails if the s parameter is null or Empty, is not in the correct format. lub reprezentuje liczbę mniejszą niż MinValue lub większą niż MaxValue., or represents a number less than MinValue or greater than MaxValue. Ten parametr jest przekazaniem niezainicjowanym; Wszelkie wartości oryginalnie podane w result zostaną nadpisywane.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Zwraca

true, jeśli s został pomyślnie przekonwertowany; w przeciwnym razie false.true if s was converted successfully; otherwise, false.

Atrybuty

Przykłady

Poniższy przykład wywołuje metodę TryParse(String, UInt16) raz dla każdego elementu w tablicy ciągów.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.

Uwagi

Metoda TryParse(String, UInt16) jest taka sama jak Metoda Parse(String), z tą różnicą, że nie zgłasza wyjątku, jeśli konwersja nie powiedzie się.The TryParse(String, UInt16) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. Ta metoda eliminuje konieczność używania obsługi wyjątków do testowania dla FormatException, jeśli s jest nieprawidłowa i nie można jej pomyślnie przeanalizować.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be successfully parsed.

Parametr s powinien być ciągiem reprezentującym liczbę dziesiętną w następującej postaci:The s parameter should be the string representation of a decimal number in the following form:

[WS] [Sign] cyfry[WS][ws][sign]digits[ws]

Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne.Elements in square brackets ([ and ]) are optional. W tabeli poniżej opisano każdy element.The following table describes each element.

ElementElement OpisDescription
wsws Opcjonalny odstęp.Optional white space.
signsign Opcjonalny znak.An optional sign. Prawidłowe znaki znakowe są określane przez NumberFormatInfo.NegativeSign i NumberFormatInfo.PositiveSign właściwości bieżącej kultury.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
cyfrdigits Sekwencja cyfr dziesiętnych od 0 do 9.A sequence of decimal digits ranging from 0 to 9.

Uwaga

Ciąg określony przez parametr s nie może zawierać żadnych separatorów grup ani separatorów dziesiętnych i nie może mieć części dziesiętnej.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

s parametr jest interpretowany przy użyciu stylu NumberStyles.Integer.The s parameter is interpreted by using the NumberStyles.Integer style. Poza cyframi dziesiętnymi dopuszcza się tylko spacje początkowe i końcowe z wiodącym znakiem.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Aby jawnie zdefiniować elementy stylu przy użyciu informacji o formatowaniu specyficznych dla kultury, które mogą być obecne w s, wywołaj metodę TryParse(String, NumberStyles, IFormatProvider, UInt16).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.

s parametr jest analizowany przy użyciu informacji o formatowaniu w obiekcie NumberFormatInfo dla bieżącej kultury systemowej.The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. Aby uzyskać więcej informacji, zobacz temat NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

To Przeciążenie interpretuje wszystkie cyfry w s parametr jako cyfry dziesiętne.This overload interprets all digits in the s parameter as decimal digits. Aby przeanalizować ciąg reprezentujący liczbę szesnastkową, wywołaj zamiast niego Przeciążenie TryParse(String, NumberStyles, IFormatProvider, UInt16).To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) overload instead.

Zobacz też

TryParse(ReadOnlySpan<Char>, UInt16)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Próbuje skonwertować reprezentację zakresu liczby na jej odpowiednik 16-bitową liczbą całkowitą bez znaku.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

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

Parametry

s
ReadOnlySpan<Char>

Zakres zawierający znaki reprezentujące liczbę do przekonwertowania.A span containing the characters representing the number to convert.

result
UInt16

Gdy ta metoda zwraca, zawiera 16-bitową liczbę całkowitą bez znaku, która jest równoważna liczbie zawartej w s, jeśli konwersja zakończyła się powodzeniem lub zero, jeśli konwersja nie powiodła się.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. Konwersja nie powiedzie się, jeśli parametr s jest null lub Empty, nie ma poprawnego formatu.The conversion fails if the s parameter is null or Empty, is not in the correct format. lub reprezentuje liczbę mniejszą niż MinValue lub większą niż MaxValue., or represents a number less than MinValue or greater than MaxValue. Ten parametr jest przekazaniem niezainicjowanym; Wszelkie wartości oryginalnie podane w result zostaną nadpisywane.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Zwraca

true, jeśli s został pomyślnie przekonwertowany; w przeciwnym razie false.true if s was converted successfully; otherwise, false.

Atrybuty

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Alternatywa zgodna ze specyfikacją CLS
System.Int32.TryParse(String, Int32)

Próbuje przekonwertować ciąg reprezentujący liczbę w określonym stylu i formacie specyficznym dla kultury na jego 16-bitową liczbę całkowitą bez znaku.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.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

Parametry

s
String

Ciąg reprezentujący liczbę, którą należy przekształcić.A string that represents the number to convert. Ciąg jest interpretowany przy użyciu stylu określonego przez parametr style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles

Bitowa kombinacja wartości wyliczenia wskazująca dozwolony format s.A bitwise combination of enumeration values that indicates the permitted format of s. Typową wartością do określenia jest Integer.A typical value to specify is Integer.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury dotyczące s.An object that supplies culture-specific formatting information about s.

result
UInt16

Gdy ta metoda zwraca, zawiera 16-bitową liczbę całkowitą bez znaku, odpowiadającą liczbie zawartej w s, jeśli konwersja zakończyła się powodzeniem, lub zero, jeśli konwersja nie powiodła się.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. Konwersja nie powiedzie się, jeśli parametr s jest null lub Empty, nie jest w formacie zgodnym z stylelub reprezentuje liczbę mniejszą niż MinValue lub większą niż MaxValue.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. Ten parametr jest przekazaniem niezainicjowanym; Wszelkie wartości oryginalnie podane w result zostaną nadpisywane.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Zwraca

true, jeśli s został pomyślnie przekonwertowany; w przeciwnym razie false.true if s was converted successfully; otherwise, false.

Atrybuty

Wyjątki

style nie jest wartością NumberStyles.style is not a NumberStyles value.

lub-or- style nie jest kombinacją wartości AllowHexSpecifier i HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Przykłady

Poniższy przykład wywołuje metodę TryParse(String, NumberStyles, IFormatProvider, UInt16) z liczbą różnych ciągów i NumberStyles wartościami.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.

Uwagi

Metoda TryParse(String, NumberStyles, IFormatProvider, UInt16) jest taka sama jak Metoda Parse(String, NumberStyles, IFormatProvider), z tą różnicą, że nie zgłasza wyjątku, jeśli konwersja nie powiedzie się.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. Ta metoda eliminuje konieczność użycia obsługi wyjątków w celu przetestowania dla FormatException, jeśli s jest nieprawidłowa i nie można jej przeanalizować pomyślnie.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

style parametr definiuje elementy stylu (takie jak odstępy czy znak dodatni lub ujemny), które są dozwolone w parametrze s w celu pomyślnego wykonania operacji analizy.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. Musi to być kombinacja flag bitowych z wyliczenia NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. W zależności od wartości styleparametr s może zawierać następujące elementy:Depending on the value of style, the s parameter may include the following elements:

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

Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne.Items in square brackets ([ and ]) are optional. Lub, jeśli parametr style zawiera AllowHexSpecifier, parametr s może zawierać następujące elementy:Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

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

W tabeli poniżej opisano każdy element.The following table describes each element.

wsws
Opcjonalny odstęp.Optional white space. Odstępy mogą pojawić się na początku s, jeśli style zawiera flagę NumberStyles.AllowLeadingWhite lub na końcu s, jeśli style zawiera flagę NumberStyles.AllowTrailingWhite.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.

$
Symbol waluty specyficzny dla kultury.A culture-specific currency symbol. Jego pozycja w ciągu jest definiowana przez właściwość CurrencyPositivePattern obiektu NumberFormatInfo zwróconego przez metodę GetFormat parametru provider.Its position in the string is defined by the CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Symbol waluty może pojawić się w s, jeśli style zawiera flagę NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
Opcjonalny znak.An optional sign. Znak może występować na początku s, jeśli style zawiera flagę NumberStyles.AllowLeadingSign i może być wyświetlany na końcu s, jeśli style zawiera flagę NumberStyles.AllowTrailingSign.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. Nawiasy mogą być używane w s, aby wskazać wartość ujemną, jeśli style zawiera flagę NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Jeśli jednak znak ujemny jest obecny, s może reprezentować tylko wartość zero dla operacji analizy.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.

cyfrdigits
Sekwencja cyfr od 0 do 9.A sequence of digits from 0 through 9.

,,
Separator grupy specyficzny dla kultury.A culture-specific group separator. Separator grupy kultury określony przez provider może pojawić się w s, jeśli style zawiera flagę NumberStyles.AllowThousands.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.

..
Symbol dziesiętny specyficzny dla kultury.A culture-specific decimal point symbol. Symbol separatora dziesiętnego kultury określonej przez provider może pojawić się w s, jeśli style zawiera flagę NumberStyles.AllowDecimalPoint.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.

fractional_digitsfractional_digits
Jedno lub więcej wystąpień cyfry 0.One or more occurrences of the digit 0. Cyfry ułamkowe mogą występować w s tylko wtedy, gdy style zawiera flagę NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.

EE
Znak „e” lub „E”, który wskazuje, że wartość jest reprezentowana w zapisie wykładniczym (naukowym).The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Parametr s może reprezentować liczbę w notacji wykładniczej, jeśli style zawiera flagę NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

exponential_digitsexponential_digits
Sekwencja cyfr od 0 do 9.A sequence of digits from 0 through 9. Parametr s może reprezentować liczbę w notacji wykładniczej, jeśli style zawiera flagę NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

hexdigitshexdigits
Sekwencja cyfr szesnastkowych od 0 do f lub od 0 do F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Uwaga

Wszelkie kończące się znaki NUL (U + 0000) w s są ignorowane przez operację analizowania, niezależnie od wartości argumentu style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Ciąg z tylko cyframi dziesiętnymi (które odpowiada flagi NumberStyles.None) zawsze analizuje się pomyślnie.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Większość pozostałych NumberStyles elementów członkowskich kontroluje elementy, które mogą być obecne, ale nie muszą być obecne w tym ciągu wejściowym.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. Poniższa tabela zawiera informacje o tym, w jaki sposób poszczególne NumberStyles członkowie wpływają na elementy, które mogą być obecne w s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Niezłożone wartości NumberStylesNon-composite NumberStyles values Dodatkowe (poza cyframi) elementy dozwolone w wartościElements permitted in value in addition to digits
None Tylko cyfry dziesiętne.Decimal digits only.
AllowDecimalPoint Elementy dziesiętne (.) i fractional_digits .The decimal point (.) and fractional_digits elements. Jednak fractional_digits muszą zawierać tylko jedną lub więcej cyfr 0 lub metoda zwraca false.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Znak "e" lub "E", który wskazuje notację wykładniczą oraz exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Jeśli s reprezentuje liczbę w notacji wykładniczej, nie może ona mieć części ułamkowej.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Element WS na początku s.The ws element at the start of s.
AllowTrailingWhite Element WS na końcu s.The ws element at the end of s.
AllowLeadingSign Element Sign przed cyframi.The sign element before digits.
AllowTrailingSign Element Sign po cyfrach.The sign element after digits.
AllowParentheses Element Sign w postaci nawiasów otaczających zerową wartość liczbową.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Element separatora grupy (,).The group separator (,) element.
AllowCurrencySymbol Element Currency ($).The currency ($) element.
Currency Wszystkie elementy.All elements. Jednak s nie może reprezentować liczby szesnastkowej ani liczby w notacji wykładniczej.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Element WS na początku lub na końcu s, Podpisz na początku si symbol separatora dziesiętnego (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Parametr s może również używać notacji wykładniczej.The s parameter can also use exponential notation.
Number Elementy WS, Sign, separator grupy (,) i punkt dziesiętny (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Wszystkie elementy.All elements. Jednak s nie może reprezentować liczby szesnastkowej.However, s cannot represent a hexadecimal number.

Jeśli jest używana flaga NumberStyles.AllowHexSpecifier, s musi być wartością szesnastkową.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Prawidłowe cyfry szesnastkowe to od 0 do 9, od do f i od A do F. Prefiks, taki jak "0x", nie jest obsługiwany i powoduje niepowodzenie operacji analizy.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. Jedyne inne flagi, które mogą być obecne w styleNumberStyles.AllowLeadingWhite i NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Wyliczenie NumberStyles ma styl złożony, HexNumber, który zawiera obie flagi odstępu.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Uwaga

Jeśli s to ciąg reprezentujący liczbę szesnastkową, nie może być poprzedzony żadnym dekoracją (np. 0x lub &h), który odróżnia go jako liczbę szesnastkową.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. To powoduje niepowodzenie konwersji.This causes the conversion to fail.

provider parametr jest implementacją IFormatProvider.The provider parameter is an IFormatProvider implementation. Metoda GetFormat zwraca obiekt NumberFormatInfo, który zawiera informacje specyficzne dla kultury dotyczące formatu s.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Parametr provider może mieć jedną z następujących wartości:The provider parameter can be any one of the following:

Jeśli provider jest null, zostanie użyty obiekt NumberFormatInfo dla bieżącej kultury.If provider is null, the NumberFormatInfo object for the current culture is used.

Zobacz też

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

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Próbuje skonwertować reprezentację zakresu liczby w określonym stylu i formacie specyficznym dla kultury na odpowiadającą jej 16-bitową liczbę całkowitą bez znaku.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Zwracana wartość wskazuje, czy konwersja powiodła się czy nie.A return value indicates whether the conversion succeeded or failed.

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

Parametry

s
ReadOnlySpan<Char>

Zakres zawierający znaki, które reprezentują liczbę do przekonwertowania.A span containing the characters that represent the number to convert. Zakres jest interpretowany przy użyciu stylu określonego przez parametr style.The span is interpreted by using the style specified by the style parameter.

style
NumberStyles

Bitowa kombinacja wartości wyliczenia wskazująca dozwolony format s.A bitwise combination of enumeration values that indicates the permitted format of s. Typową wartością do określenia jest Integer.A typical value to specify is Integer.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury dotyczące s.An object that supplies culture-specific formatting information about s.

result
UInt16

Gdy ta metoda zwraca, zawiera 16-bitową liczbę całkowitą bez znaku, odpowiadającą liczbie zawartej w s, jeśli konwersja zakończyła się powodzeniem, lub zero, jeśli konwersja nie powiodła się.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. Konwersja nie powiedzie się, jeśli parametr s jest null lub Empty, nie jest w formacie zgodnym z stylelub reprezentuje liczbę mniejszą niż MinValue lub większą niż MaxValue.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. Ten parametr jest przekazaniem niezainicjowanym; Wszelkie wartości oryginalnie podane w result zostaną nadpisywane.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Zwraca

true, jeśli s został pomyślnie przekonwertowany; w przeciwnym razie false.true if s was converted successfully; otherwise, false.

Atrybuty

Dotyczy