UInt16.TryParse Метод

Определение

Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число без знака.Converts the string representation of a number to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

Перегрузки

TryParse(String, UInt16)

Предпринимает попытку преобразования строкового представления числа в эквивалентное ему 16-разрядное целое число без знака.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt16)

Пытается преобразовать представление числа в виде диапазона в эквивалентное ему 16-битовое целое число без знака.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Предпринимает попытку преобразовать строковое представление числа в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное 16-разрядное целое число без знака.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

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

Пытается преобразовать представление числа в виде диапазона в формате, соответствующем определенному стилю, языку и региональным параметрам, в эквивалентное 16-битовое целое число без знака.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.A return value indicates whether the conversion succeeded or failed.

TryParse(String, UInt16)

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS
System.Int32.TryParse(String, Int32)

Предпринимает попытку преобразования строкового представления числа в эквивалентное ему 16-разрядное целое число без знака.Tries to convert the string representation of a number to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.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

Параметры

s
String

Строка, представляющая преобразуемое число.A string that represents the number to convert.

result
UInt16

После завершения метода содержит 16-разрядное целое число без знака, эквивалентное числу, содержавшемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачно.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. Преобразование завершается ошибкой, если параметр s имеет значение null или Empty (неверный формат).The conversion fails if the s parameter is null or Empty, is not in the correct format. или представляет число, меньше MinValue либо больше MaxValue., or represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Атрибуты

Примеры

В следующем примере метод TryParse(String, UInt16) вызывается один раз для каждого элемента в массиве строк.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.

Комментарии

Метод TryParse(String, UInt16) похож на метод Parse(String), за исключением того, что он не создает исключение в случае сбоя преобразования.The TryParse(String, UInt16) method is like the Parse(String) method, except that it does not throw an exception if the conversion fails. Этот метод избавляет от необходимости использовать обработку исключений для проверки FormatException если s недопустим и не может быть успешно проанализирован.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be successfully parsed.

Параметр s должен быть строковым представлением десятичного числа в следующей форме:The s parameter should be the string representation of a decimal number in the following form:

[WS] [Sign] цифры[WS][ws][sign]digits[ws]

Элементы в квадратных скобках ([и]) являются необязательными.Elements in square brackets ([ and ]) are optional. Каждый из элементов описан в таблице ниже.The following table describes each element.

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space.
signsign Необязательный знак.An optional sign. Допустимые знаки знака определяются NumberFormatInfo.NegativeSign и NumberFormatInfo.PositiveSign свойствами текущего языка и региональных параметров.Valid sign characters are determined by the NumberFormatInfo.NegativeSign and NumberFormatInfo.PositiveSign properties of the current culture.
digitsdigits Последовательность десятичных цифр в диапазоне от 0 до 9.A sequence of decimal digits ranging from 0 to 9.

Примечание

Строка, заданная параметром s, не может содержать разделители групп или десятичный разделитель, а также не может иметь дробную часть.The string specified by the s parameter cannot contain any group separators or decimal separator, and it cannot have a decimal portion.

Параметр s интерпретируется с помощью стиля NumberStyles.Integer.The s parameter is interpreted by using the NumberStyles.Integer style. В дополнение к десятичным цифрам допускаются только ведущие и конечные пробелы с ведущим знаком.In addition to the decimal digits, only leading and trailing spaces with a leading sign are allowed. Чтобы явно определить элементы стиля с использованием сведений об особенностях форматирования, связанных с языком и региональными параметрами, которые могут присутствовать в s, вызовите метод 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 анализируется с помощью сведений о форматировании в объекте NumberFormatInfo для текущего языка и региональных параметров системы.The s parameter is parsed by using the formatting information in a NumberFormatInfo object for the current system culture. Для получения дополнительной информации см. NumberFormatInfo.CurrentInfo.For more information, see NumberFormatInfo.CurrentInfo.

Эта перегрузка интерпретирует все цифры в параметре s как десятичные цифры.This overload interprets all digits in the s parameter as decimal digits. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите вместо этого метод перегрузки TryParse(String, NumberStyles, IFormatProvider, UInt16).To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, UInt16) overload instead.

Дополнительно

TryParse(ReadOnlySpan<Char>, UInt16)

Важно!

Этот API несовместим с CLS.

Пытается преобразовать представление числа в виде диапазона в эквивалентное ему 16-битовое целое число без знака.Tries to convert the span representation of a number to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.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

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий символы, которые представляют преобразуемое число.A span containing the characters representing the number to convert.

result
UInt16

При возвращении этим методом содержит 16-разрядное целочисленное значение без знака, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось сбоем.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. Преобразование завершается ошибкой, если параметр s имеет значение null или Empty (неверный формат).The conversion fails if the s parameter is null or Empty, is not in the correct format. или представляет число, меньше MinValue либо больше MaxValue., or represents a number less than MinValue or greater than MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Атрибуты

TryParse(String, NumberStyles, IFormatProvider, UInt16)

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS
System.Int32.TryParse(String, Int32)

Предпринимает попытку преобразовать строковое представление числа в формате, соответствующем стилю, языку и региональным параметрам, в эквивалентное 16-разрядное целое число без знака.Tries to convert the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.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

Параметры

s
String

Строка, представляющая преобразуемое число.A string that represents the number to convert. Строка интерпретируется с использованием стиля, указанного параметром style.The string is interpreted by using the style specified by the style parameter.

style
NumberStyles

Побитовая комбинация значений перечисления, которая показывает разрешенный формат параметра s.A bitwise combination of enumeration values that indicates the permitted format of s. Обычно указывается значение Integer.A typical value to specify is Integer.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

result
UInt16

При возвращении этим методом содержит 16-разрядное целочисленное значение без знака, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.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. Преобразование завершается сбоем, если параметр s равен null или Empty, не находится в формате, совместимом с style или представляет собой число меньше MinValue или больше 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. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Атрибуты

Исключения

style не является значением NumberStyles.style is not a NumberStyles value.

- или --or- style не является сочетанием значений AllowHexSpecifier и HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

Примеры

В следующем примере вызывается метод TryParse(String, NumberStyles, IFormatProvider, UInt16) с количеством различных строк и NumberStyles значений.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.

Комментарии

Метод TryParse(String, NumberStyles, IFormatProvider, UInt16) похож на метод Parse(String, NumberStyles, IFormatProvider), за исключением того, что он не создает исключение в случае сбоя преобразования.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. Этот метод устраняет необходимость использования обработки исключений для проверки FormatException, если s является недопустимой и не может быть успешно проанализирована.This method eliminates the need to use exception handling to test for a FormatException if s is invalid and cannot be parsed successfully.

Параметр style определяет элементы стиля (например, пробелы или положительный или отрицательный знак), допустимые в параметре s для успешной операции синтаксического анализа.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. Он должен представлять собой сочетание битовых флагов из перечисления NumberStyles.It must be a combination of bit flags from the NumberStyles enumeration. В зависимости от значения styleпараметр s может включать следующие элементы:Depending on the value of style, the s parameter may include the following elements:

[WS] [$] [Sign] [цифры,] цифры[. fractional_digits] [E [sign]exponential_digits] [WS][ws][$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]

Элементы в квадратных скобках ([и]) являются необязательными.Items in square brackets ([ and ]) are optional. Или, если параметр style включает AllowHexSpecifier, параметр s может включать следующие элементы:Or, if the style parameter includes AllowHexSpecifier, the s parameter may include the following elements:

[WS] хексдигитс[WS][ws]hexdigits[ws]

Каждый из элементов описан в таблице ниже.The following table describes each element.

wsws
Необязательный пробел.Optional white space. Пробелы могут присутствовать в начале s если style включает флаг NumberStyles.AllowLeadingWhite или в конце s, если style включает флаг 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.

$
Символ валюты, зависящий от языка и региональных параметров.A culture-specific currency symbol. Его расположение в строке определяется свойством CurrencyPositivePattern объекта NumberFormatInfo, возвращаемого методом GetFormat параметра 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. Символ валюты может отображаться в s, если style включает флаг NumberStyles.AllowCurrencySymbol.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.

signsign
Необязательный знак.An optional sign. Знак может появиться в начале s если style включает флаг NumberStyles.AllowLeadingSign и может находиться в конце s, если style включает флаг 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. Круглые скобки можно использовать в s, чтобы указать отрицательное значение, если style включает флаг NumberStyles.AllowParentheses.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag. Однако при наличии отрицательного знака s может представлять только нулевое значение для выполнения операции синтаксического анализа.However, if the negative sign is present, s can only represent the value zero for the parse operation to succeed.

digitsdigits
Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9.

,,
Разделитель групп, зависящий от языка и региональных параметров.A culture-specific group separator. Разделитель групп языка и региональных параметров, заданный provider, может отображаться в s, если style включает флаг NumberStyles.AllowThousands.The group separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.

..
Символ десятичной запятой, зависящий от языка и региональных параметров.A culture-specific decimal point symbol. Символ десятичной запятой для языка и региональных параметров, заданный provider, может присутствовать в s, если style включает флаг 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
Одно или несколько вхождений цифры 0.One or more occurrences of the digit 0. Дробные цифры могут присутствовать в s только в том случае, если style включает флаг NumberStyles.AllowDecimalPoint.Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.

EE
Символ "e" или "E", указывающий, что значение представлено в экспоненциальной (экспоненциальной) нотации.The "e" or "E" character, which indicates that the value is represented in exponential (scientific) notation. Параметр s может представлять число в экспоненциальной нотации, если style включает флаг NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

exponential_digitsexponential_digits
Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9. Параметр s может представлять число в экспоненциальной нотации, если style включает флаг NumberStyles.AllowExponent.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.

хексдигитсhexdigits
Последовательность шестнадцатеричных цифр от 0 до f или от 0 до F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Примечание

Все завершающие символы NUL (U + 0000) в s игнорируются операцией синтаксического анализа независимо от значения аргумента style.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Строка с десятичными цифрами (которая соответствует флагу NumberStyles.None) всегда будет успешно проанализирована.A string with decimal digits only (which corresponds to the NumberStyles.None flag) always parses successfully. Большинство оставшихся NumberStyles элементов управляют элементами управления, которые могут присутствовать, но не обязательно должны присутствовать в этой входной строке.Most of the remaining NumberStyles members control elements that may be present, but are not required to be present, in this input string. В следующей таблице показано, как отдельные члены NumberStyles влияют на элементы, которые могут присутствовать в s.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Несоставные значения NumberStylesNon-composite NumberStyles values Разрешенные в значениях элементы в дополнение к цифрамElements permitted in value in addition to digits
None Только десятичные цифры.Decimal digits only.
AllowDecimalPoint Элементы десятичной запятой (.) и fractional_digits .The decimal point (.) and fractional_digits elements. Однако fractional_digits должны состоять только из одной или нескольких цифр 0 или метод возвращает false.However, fractional_digits must consist of only one or more 0 digits, or the method returns false.
AllowExponent Символ "e" или "E", который указывает на экспоненциальную нотацию, а также exponential_digits.The "e" or "E" character, which indicates exponential notation, along with exponential_digits. Если s представляет число в экспоненциальной нотации, оно не может содержать Ненулевой, дробный компонент.If s represents a number in exponential notation, it cannot have a non-zero, fractional component.
AllowLeadingWhite Элемент WS в начале s.The ws element at the start of s.
AllowTrailingWhite Элемент WS в конце s.The ws element at the end of s.
AllowLeadingSign Элемент Sign перед цифрами.The sign element before digits.
AllowTrailingSign Элемент Sign после разрядов.The sign element after digits.
AllowParentheses Элемент Sign в виде круглых скобок, включающих нулевое числовое значение.The sign element in the form of parentheses enclosing a zero numeric value.
AllowThousands Элемент разделителя групп (,).The group separator (,) element.
AllowCurrencySymbol Элемент Currency ($).The currency ($) element.
Currency Все элементы.All elements. Однако s не может представлять шестнадцатеричное число или число в экспоненциальной нотации.However, s cannot represent a hexadecimal number or a number in exponential notation.
Float Элемент WS в начале или в конце s, знак в начале sи символ десятичной запятой (.).The ws element at the start or end of s, sign at the start of s, and the decimal point (.) symbol. Параметр s может также использовать экспоненциальную нотацию.The s parameter can also use exponential notation.
Number Элементы WS, Sign, Group separator (,) и Decimal (.).The ws, sign, group separator (,), and decimal point (.) elements.
Any Все элементы.All elements. Однако s не может представлять шестнадцатеричное число.However, s cannot represent a hexadecimal number.

Если используется флаг NumberStyles.AllowHexSpecifier, s должен быть шестнадцатеричным значением.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value. Допустимые шестнадцатеричные цифры: от 0 до 9, от a до f и от A до F. Префикс, такой как 0x, не поддерживается и приводит к сбою операции синтаксического анализа.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. Единственными другими флагами, которые могут присутствовать в style, являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет составной стиль, HexNumber, включающий оба флага пробела.)(The NumberStyles enumeration has a composite style, HexNumber, that includes both white-space flags.)

Примечание

Если s является строковым представлением шестнадцатеричного числа, ему не может предшествовать любое декорирование (например, 0x или &h), которое отличает его как шестнадцатеричное число.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. Это приводит к сбою преобразования.This causes the conversion to fail.

Параметр provider является реализацией IFormatProvider.The provider parameter is an IFormatProvider implementation. Его GetFormat метод возвращает объект NumberFormatInfo, предоставляющий сведения о формате sв зависимости от языка и региональных параметров.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of s. Параметр provider может быть одним из следующих:The provider parameter can be any one of the following:

  • Объект CultureInfo, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании.A CultureInfo object that represents the culture that supplies formatting information. Его GetFormat метод возвращает объект NumberFormatInfo, который предоставляет сведения о форматировании числовых значений для этого языка и региональных параметров.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Объект NumberFormatInfo, предоставляющий сведения о форматировании чисел.A NumberFormatInfo object that provides numeric formatting information. (Его реализация GetFormat просто возвращает сам себя.)(Its implementation of GetFormat just returns itself.)

  • Пользовательский объект, реализующий IFormatProvider.A custom object that implements IFormatProvider. Его GetFormat метод создает экземпляр и возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Если provider null, используется объект NumberFormatInfo для текущего языка и региональных параметров.If provider is null, the NumberFormatInfo object for the current culture is used.

Дополнительно

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

Важно!

Этот API несовместим с CLS.

Пытается преобразовать представление числа в виде диапазона в формате, соответствующем определенному стилю, языку и региональным параметрам, в эквивалентное 16-битовое целое число без знака.Tries to convert the span representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent. Возвращает значение, указывающее, успешно ли выполнено преобразование.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

Параметры

s
ReadOnlySpan<Char>

Диапазон, содержащий символы, которые представляют преобразуемое число.A span containing the characters that represent the number to convert. Диапазон интерпретируется с использованием стиля, указанного в параметре style.The span is interpreted by using the style specified by the style parameter.

style
NumberStyles

Побитовая комбинация значений перечисления, которая показывает разрешенный формат параметра s.A bitwise combination of enumeration values that indicates the permitted format of s. Обычно указывается значение Integer.A typical value to specify is Integer.

provider
IFormatProvider

Объект, который предоставляет сведения о форматировании параметра s в зависимости от языка и региональных параметров.An object that supplies culture-specific formatting information about s.

result
UInt16

При возвращении этим методом содержит 16-разрядное целочисленное значение без знака, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.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. Преобразование завершается сбоем, если параметр s равен null или Empty, не находится в формате, совместимом с style или представляет собой число меньше MinValue или больше 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. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result, будет перезаписано.This parameter is passed uninitialized; any value originally supplied in result will be overwritten.

Возвраты

Значение true, если параметр s успешно преобразован; в противном случае — значение false.true if s was converted successfully; otherwise, false.

Атрибуты

Применяется к