Int16.TryParse Метод

Определение

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

Перегрузки

TryParse(String, Int16)

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

TryParse(ReadOnlySpan<Char>, Int16)

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

TryParse(String, NumberStyles, IFormatProvider, Int16)

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

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

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

TryParse(String, Int16)

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

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (string s, out short result);
static member TryParse : string * int16 -> bool
Public Shared Function TryParse (s As String, ByRef result As Short) As Boolean

Параметры

s
String

Строка, содержащая преобразуемое число.A string containing a number to convert.

result
Int16

При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.When this method returns, contains the 16-bit signed integer value equivalent to the number contained in s, if the conversion succeeded, or zero if the conversion failed. Преобразование завершается сбоем, если параметр s равен null или Empty, не находится в правильном формате или представляет число меньше MinValue или больше MaxValue.The conversion fails if the s parameter is null or Empty, is not of the correct format, 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.

Примеры

В следующем примере вызывается метод Int16.TryParse(String, Int16) с несколькими различными строковыми значениями.The following example calls the Int16.TryParse(String, Int16) method with a number of different string values.

using System;

public class StringParsing
{
   public static void Main()
   {
      TryToParse(null);
      TryToParse("16051");
      TryToParse("9432.0");
      TryToParse("16,667");
      TryToParse("   -322   ");
      TryToParse("+4302");
      TryToParse("(100);");
      TryToParse("01FA");
   }

   private static void TryToParse(string value)
   {
      short number;
      bool result = Int16.TryParse(value, out number);
      if (result)
      {
         Console.WriteLine("Converted '{0}' to {1}.", value, number);         
      }
      else
      {
         if (value == null) value = ""; 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value);
      }
   }
}
// The example displays the following output to the console:
//       Attempted conversion of '' failed.
//       Converted '16051' to 16051.
//       Attempted conversion of '9432.0' failed.
//       Attempted conversion of '16,667' failed.
//       Converted '   -322   ' to -322.
//       Converted '+4302' to 4302.
//       Attempted conversion of '(100)' failed.
//       Attempted conversion of '01FA' failed.
Module StringParsing
   Public Sub Main()
      TryToParse(Nothing)
      TryToParse("16051")
      TryToParse("9432.0")
      TryToParse("16,667")
      TryToParse("   -322   ")
      TryToParse("+4302")
      TryToParse("(100)")
      TryToParse("01FA")
      
   End Sub
   
   Private Sub TryToParse(value As String)
      Dim number As Int16
      Dim result As Boolean = Int16.TryParse(value, number)
      If result Then
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Else
         If value Is Nothing Then value = "" 
         Console.WriteLine("Attempted conversion of '{0}' failed.", value)
      End If     
   End Sub
End Module
' The example displays the following output to the console:
'       Attempted conversion of '' failed.
'       Converted '16051' to 16051.
'       Attempted conversion of '9432.0' failed.
'       Attempted conversion of '16,667' failed.
'       Converted '   -322   ' to -322.
'       Converted '+4302' to 4302.
'       Attempted conversion of '(100)' failed.
'       Attempted conversion of '01FA' failed.

Некоторые строки, которые метод TryParse(String, Int16) не может преобразовать в этом примере:Some of the strings that the TryParse(String, Int16) method is unable to convert in this example are:

  • "9432.0"."9432.0". Преобразование завершается неудачей, поскольку строка не может содержать десятичный разделитель; Он должен содержать только цифры целой части.The conversion fails because the string cannot contain a decimal separator; it must contain integral digits only.

  • "16,667"."16,667". Преобразование завершается неудачей, поскольку строка не может содержать разделители групп; Он должен содержать только цифры целой части.The conversion fails because the string cannot contain group separators; it must contain integral digits only.

  • "(100)"."(100)". Преобразование завершается неудачей, так как строка не может содержать знак минуса, отличный от того, который определен свойствами NumberFormatInfo.NegativeSign и NumberFormatInfo.NumberNegativePattern текущего языка и региональных параметров.The conversion fails because the string cannot contain a negative sign other than the one defined by the current culture's NumberFormatInfo.NegativeSign and NumberFormatInfo.NumberNegativePattern properties.

  • "01FA"."01FA". Преобразование завершается неудачей, поскольку строка не может содержать шестнадцатеричные цифры; Он должен содержать только десятичные цифры.The conversion fails because the string cannot contain hexadecimal digits; it must contain decimal digits only.

Комментарии

Метод Int16.TryParse(String, Int16) отличается от метода Int16.Parse(String), возвращая логическое значение, которое указывает, была ли операция синтаксического анализа успешной, вместо возврата проанализированного значения Int16.The Int16.TryParse(String, Int16) method differs from the Int16.Parse(String) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed Int16 value. Это устраняет необходимость использования обработки исключений для проверки FormatException в случае, если s недопустим и не может быть успешно проанализирован.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Параметр s должен быть строковым представлением числа в виде:The s parameter should be the string representation of a number in the form:

Протокол [знак] цифры [ws][ws][sign]digits[ws]

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

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space.
signsign Необязательный знак.An optional sign.
digitsdigits Последовательность цифр в диапазоне от 0 до 9.A sequence of digits ranging from 0 to 9.

Параметр s интерпретируется с помощью стиля NumberStyles.Integer.The s parameter is interpreted using the NumberStyles.Integer style. В дополнение к десятичным цифрам допускаются только ведущие и замыкающие пробелы, а также ведущий символ.In addition to the decimal digits, only leading and trailing spaces together with a leading sign are allowed. Чтобы явно определить элементы стиля вместе с данными форматирования, зависящими от языка и региональных параметров, которые могут присутствовать в s, используйте метод Int16.TryParse(String, NumberStyles, IFormatProvider, Int16).To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) method.

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo, который инициализируется для текущего языка и региональных параметров системы.The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Для получения дополнительной информации см. CurrentInfo.For more information, see CurrentInfo.

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

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

TryParse(ReadOnlySpan<Char>, Int16)

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

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (ReadOnlySpan<char> s, out short result);
static member TryParse : ReadOnlySpan<char> * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As Short) As Boolean

Параметры

s
ReadOnlySpan<Char>

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

result
Int16

При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.When this method returns, contains the 16-bit signed 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.

TryParse(String, NumberStyles, IFormatProvider, Int16)

Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком.Converts the string representation of a number in a specified style and culture-specific format to its 16-bit signed 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] short % result);
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out short result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s
String

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

style
NumberStyles

Побитовое сочетание значений перечисления, обозначающих элементы стиля, которые могут быть представлены в параметре s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Обычно указывается значение Integer.A typical value to specify is Integer.

provider
IFormatProvider

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

result
Int16

При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.When this method returns, contains the 16-bit signed 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.

Примеры

В следующем примере вызывается метод Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) с несколькими различными строковыми значениями.The following example calls the Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) method with a number of different string values.

using System;
using System.Globalization;

public class StringParsing
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "10677";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);

      numericString = "-30677";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "10345.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "10345.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "22,593"; 
      styles = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallTryParse(numericString, styles);
      
      numericString = "12E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
          
      numericString = "12E03";
      CallTryParse(numericString, styles); 
      
      numericString = "80c1";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x80C1";
      CallTryParse(numericString, NumberStyles.HexNumber);      
   }

   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      short number;
      bool result = Int16.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 to the console:
//       Converted '10677' to 10677.
//       Attempted conversion of '-30677' failed.
//       Converted '10345.00' to 10345.
//       Attempted conversion of '10345.72' failed.
//       Converted '22,593' to 22593.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E03' to 12000.
//       Converted '80c1' to -32575.
//       Attempted conversion of '0x80C1' failed.
Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10677"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-30677"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "10345.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "22,593" 
      styles = NumberStyles.Integer Or NumberStyles.AllowThousands
      CallTryParse(numericString, styles)
      
      numericString = "12E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
          
      numericString = "12E03"
      CallTryParse(numericString, styles) 
      
      numericString = "80c1"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x80C1"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As Short
      Dim result As Boolean = Int16.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 '10677' to 10677.
'       Attempted conversion of '-30677' failed.
'       Converted '10345.00' to 10345.
'       Attempted conversion of '10345.72' failed.
'       Converted '22,593' to 22593.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E03' to 12000.
'       Converted '80c1' to -32575.
'       Attempted conversion of '0x80C1' failed.

Комментарии

Метод Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) отличается от метода Int16.Parse(String, NumberStyles, IFormatProvider), возвращая логическое значение, которое указывает, была ли операция синтаксического анализа успешной, вместо возврата проанализированного значения Int16.The Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) method differs from the Int16.Parse(String, NumberStyles, IFormatProvider) method by returning a Boolean value that indicates whether the parse operation succeeded instead of returning the parsed Int16 value. Это устраняет необходимость использования обработки исключений для проверки FormatException в случае, если s недопустим и не может быть успешно проанализирован.It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.

Параметр 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:

Протокол [$] писать [цифры,] цифры [. fractional_digits] [e [знак] цифры] [ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]digits][ws]

Или, если параметр style включает NumberStyles.AllowHexSpecifier:Or, if the style parameter includes NumberStyles.AllowHexSpecifier:

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

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

ЭлементElement ОписаниеDescription
wsws Необязательный пробел.Optional white space. Пробелы могут присутствовать в начале s если style включает флаг NumberStyles.AllowLeadingWhite или в конце s, если style включает флаг NumberStyles.AllowTrailingWhite.White space can appear at the beginning 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.
digitsdigits Последовательность цифр от 0 до 9.A sequence of digits from 0 through 9.
,, Разделитель тысяч, зависящий от языка и региональных параметров.A culture-specific thousands separator. Разделитель тысяч языка и региональных параметров, заданный provider, может присутствовать в s, если style включает флаг NumberStyles.AllowThousands.The thousands 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 notation. Параметр 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 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 Элементы, разрешенные в s в дополнение к цифрамElements permitted in s in addition to digits
NumberStyles.None Только десятичные цифры.Decimal digits only.
NumberStyles.AllowDecimalPoint Языковой элемент .The . и fractional_digits элементы.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.
NumberStyles.AllowExponent Параметр s может также использовать экспоненциальную нотацию.The s parameter can also use exponential notation. Если s представляет число в экспоненциальной нотации, оно должно представлять целое число в диапазоне Int16 типа данных без дробного компонента, не равного нулю.If s represents a number in exponential notation, it must represent an integer within the range of the Int16 data type without a non-zero fractional component.
NumberStyles.AllowLeadingWhite Элемент WS в начале s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Элемент WS в конце s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Знак может располагаться перед цифрами.A sign can appear before digits.
NumberStyles.AllowTrailingSign Знак может располагаться после цифр.A sign can appear after digits.
NumberStyles.AllowParentheses Элемент Sign в виде круглых скобок, охватывающих числовое значение.The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands Элемент , .The , element.
NumberStyles.AllowCurrencySymbol Элемент $ .The $ element.
NumberStyles.Currency Все элементы.All elements. Параметр s не может представлять шестнадцатеричное число или число в экспоненциальной нотации.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
NumberStyles.Float Элемент WS в начале или в конце s, знак в начале sи .The ws element at the beginning or end of s, sign at the beginning of s, and the . знак.symbol. Параметр s может также использовать экспоненциальную нотацию.The s parameter can also use exponential notation.
NumberStyles.Number Элементы WS, Sign, тысячных разделителей (,) и десятичной запятой (.).The ws, sign, thousands separator (,), and decimal point (.) elements.
NumberStyles.Any Все стили, кроме s, не могут представлять шестнадцатеричное число.All styles, except s cannot represent a hexadecimal number.

Если используется флаг NumberStyles.AllowHexSpecifier, s должен быть шестнадцатеричным значением без префикса.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Например, "9AF3" успешно анализируется, но "0x9AF3" — нет.For example, "9AF3" parses successfully, but "0x9AF3" does not. Единственными другими флагами, которые могут присутствовать в style, являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет составной стиль, NumberStyles.HexNumber, включающий оба флага пробела.)(The NumberStyles enumeration has a composite style, NumberStyles.HexNumber, that includes both white space flags.)

Параметр provider — это IFormatProvider реализация, например объект CultureInfo или объект NumberFormatInfo, метод GetFormat которого возвращает объект NumberFormatInfo.The provider parameter is an IFormatProvider implementation, such as a CultureInfo object or a NumberFormatInfo object, whose GetFormat method returns a NumberFormatInfo object. Объект NumberFormatInfo предоставляет сведения о формате s, зависящие от языка и региональных параметров.The NumberFormatInfo object provides culture-specific information about the format of s. Если provider null, используется объект NumberFormatInfo для текущего языка и региональных параметров.If provider is null, the NumberFormatInfo object for the current culture is used.

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

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

Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком.Converts the span representation of a number in a specified style and culture-specific format to its 16-bit signed 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] short % result);
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out short result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean

Параметры

s
ReadOnlySpan<Char>

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

style
NumberStyles

Побитовое сочетание значений перечисления, обозначающих элементы стиля, которые могут быть представлены в параметре s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Обычно указывается значение Integer.A typical value to specify is Integer.

provider
IFormatProvider

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

result
Int16

При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей.When this method returns, contains the 16-bit signed 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.

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