Int16.Parse Метод

Определение

Пространство имен:: System

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует строковое представление числа в 16-разрядное целое число со знаком.

Перегрузки

Имя	Описание
Parse(String, NumberStyles, IFormatProvider)	Преобразует строковое представление числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Преобразует представление диапазона числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком.
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	Анализирует диапазон символов UTF-8 в значение.
Parse(String, IFormatProvider)	Преобразует строковое представление числа в указанном формате языка и региональных параметров в его 16-разрядное целое число со знаком.
Parse(String)	Преобразует строковое представление числа в 16-разрядное целое число со знаком.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Анализирует диапазон символов в значение.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Анализирует диапазон символов UTF-8 в значение.
Parse(String, NumberStyles)	Преобразует строковое представление числа в указанном стиле в его 16-разрядное целое число со знаком.

Parse(String, NumberStyles, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Преобразует строковое представление числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком.

public:
 static short Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);

public:
 static short Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<short>::Parse;

public static short Parse(string s, System.Globalization.NumberStyles style, IFormatProvider provider);

public static short Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider);

static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> int16

Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Short

Параметры

s: String

Строка, содержащая число для преобразования.

style: NumberStyles

Побитовое сочетание значений перечисления, указывающее элементы стиля, которые могут присутствовать в s. Обычное значение, которое нужно указать Integer.

provider: IFormatProvider

Объект, предоставляющий IFormatProvider сведения о sформатировании, зависящие от языка и региональных параметров.

Возвращаемое значение

Int16

16-разрядное целое число со знаком, эквивалентное числу, указанному в s.

Реализации

Parse(String, NumberStyles, IFormatProvider)

Исключения

ArgumentNullException

s равно null.

ArgumentException

style значение не является значением NumberStyles .

-или-

styleне является сочетанием значений и HexNumber значенийAllowHexSpecifier.

FormatException

s не соответствует формату, совместимом с style.

OverflowException

s представляет число меньше, чем Int16.MinValue или больше Int16.MaxValue.

-или-

s включает ненулевых дробных цифр.

Примеры

В следующем примере для анализа строковых представлений значений Int16 используется множество style параметров и provider параметров.

string value;
short number;
NumberStyles style;
CultureInfo provider;

// Parse string using "." as the thousands separator
// and " " as the decimal separator.
value = "19 694,00";
style = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands;
provider = new CultureInfo("fr-FR");

number = Int16.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '19 694,00' converted to 19694.

try
{
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '19 694,00'.

// Parse string using "$" as the currency symbol for en_GB and
// en-US cultures.
value = "$6,032.00";
style = NumberStyles.Number | NumberStyles.AllowCurrencySymbol;
provider = new CultureInfo("en-GB");

try
{
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture);
   Console.WriteLine("'{0}' converted to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", value);
}
// Displays:
//    Unable to parse '$6,032.00'.

provider = new CultureInfo("en-US");
number = Int16.Parse(value, style, provider);
Console.WriteLine("'{0}' converted to {1}.", value, number);
// Displays:
//    '$6,032.00' converted to 6032.

// Parse string using "." as the thousands separator
// and " " as the decimal separator.
let value = "19 694,00"
let style = NumberStyles.AllowDecimalPoint ||| NumberStyles.AllowThousands
let provider = CultureInfo "fr-FR"

let number = Int16.Parse(value, style, provider)
printfn $"'{value}' converted to {number}." 
// Displays:
//    '19 694,00' converted to 19694.

try
    let number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
    printfn $"'{value}' converted to {number}." 
with :? FormatException ->
    printfn $"Unable to parse '{value}'."
// Displays:
//    Unable to parse '19 694,00'.

// Parse string using "$" as the currency symbol for en_GB and
// en-US cultures.
let value = "$6,032.00"
let style = NumberStyles.Number ||| NumberStyles.AllowCurrencySymbol

try
    let number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
    printfn $"'{value}' converted to {number}." 
with :? FormatException ->
    printfn $"Unable to parse '{value}'."
// Displays:
//    Unable to parse '$6,032.00'.

let provider = CultureInfo "en-US"
let number = Int16.Parse(value, style, provider)
printfn $"'{value}' converted to {number}."
// Displays:
//    '$6,032.00' converted to 6032.

Dim value As String
Dim number As Short
Dim style As NumberStyles
Dim provider As CultureInfo

' Parse string using "." as the thousands separator 
' and " " as the decimal separator.
value = "19 694,00"
style = NumberStyles.AllowDecimalPoint Or NumberStyles.AllowThousands
provider = New CultureInfo("fr-FR")

number = Int16.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '19 694,00' converted to 19694.

Try
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '19 694,00'.

' Parse string using "$" as the currency symbol for en_GB and
' en-US cultures.
value = "$6,032.00"
style = NumberStyles.Number Or NumberStyles.AllowCurrencySymbol
provider = New CultureInfo("en-GB")

Try
   number = Int16.Parse(value, style, CultureInfo.InvariantCulture)
   Console.WriteLine("'{0}' converted to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)
End Try
' Displays:
'    Unable to parse '$6,032.00'.
                        
provider = New CultureInfo("en-US")
number = Int16.Parse(value, style, provider)
Console.WriteLine("'{0}' converted to {1}.", value, number)
' Displays:
'    '$6,032.00' converted to 6032.

Параметр style определяет элементы стиля (например, пробел или положительный знак), которые разрешены в s параметре для успешной операции синтаксического анализа. Это должно быть сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения styles параметр может включать следующие элементы:

[ws] [$] [знак] [цифры,]цифры[.fractional_digits][знак][знак][цифры][ws]

Или, если style включает AllowHexSpecifier:

[ws]hexdigits[ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Элемент	Описание
ws	Необязательный пробел. Пробел может отображаться в начале `s` , если `style` он содержит NumberStyles.AllowLeadingWhite флаг, или в конце `s` , если `style` этот флаг включен NumberStyles.AllowTrailingWhite .
$	Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется и NumberFormatInfo.CurrencyPositivePattern свойствами NumberFormatInfo.CurrencyNegativePattern текущего языка и региональных параметров. Символ валюты текущего языка и региональных параметров может отображаться в `s` том случае, если `style` он включает NumberStyles.AllowCurrencySymbol флаг.
знак	Необязательный знак. Знак может отображаться в начале `s` , если `style` он включает NumberStyles.AllowLeadingSign флаг, и он может отображаться в конце `s` , если `style` он включает NumberStyles.AllowTrailingSign флаг. Скобки можно использовать для `s` указания отрицательного `style` значения, если NumberStyles.AllowParentheses он содержит флаг.
Цифр	Последовательность цифр от 0 до 9.
,	Символ разделителя тысяч, зависящих от языка и региональных параметров. Символ разделителя тысяч текущего языка и региональных параметров может отображаться в `s` том случае, если `style` он NumberStyles.AllowThousands содержит флаг.
.	Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой текущего языка и региональных параметров может отображаться при `sstyle` наличии флага NumberStyles.AllowDecimalPoint .
fractional_digits	Последовательность цифры 0. Дробные цифры могут отображаться при `sstyle` включении флага NumberStyles.AllowDecimalPoint . Если любое число, отличное от 0, отображается в fractional_digits, метод создает исключение OverflowException.
e	Символ E или E, указывающий, что `s` может быть представлено в экспоненциальной нотации. Параметр `s` может представлять число в экспоненциальной нотации, если `style` он включает NumberStyles.AllowExponent флаг. `s` Однако параметр должен представлять число в диапазоне Int16 типа данных и не может иметь ненулевых дробных компонентов.
hexdigits	Последовательность шестнадцатеричных цифр от 0 до f или 0 до F.

Заметка

Все завершающие символы s NUL (U+0000) игнорируются операцией синтаксического анализа независимо от значения аргумента style .

Строка только с цифрами (которая соответствует NumberStyles.None стилю) всегда анализируется успешно. Большинство остальных NumberStyles элементов управления элементами управления, которые могут быть, но не обязательно должны присутствовать в этой входной строке. В следующей таблице показано, как отдельные NumberStyles элементы влияют на элементы, которые могут присутствовать в s.

Не составные значения NumberStyles	Элементы, разрешенные в s в дополнение к цифрам
NumberStyles.None	Только десятичные цифры.
NumberStyles.AllowDecimalPoint	Элементы . и fractional_digits . Однако fractional_digits должны состоять только из одного или нескольких 0 цифр или OverflowException создается.
NumberStyles.AllowExponent	Параметр `s` также может использовать экспоненциальную нотацию.
NumberStyles.AllowLeadingWhite	Элемент ws в начале `s`.
NumberStyles.AllowTrailingWhite	Элемент ws в конце `s`.
NumberStyles.AllowLeadingSign	Знак может появиться перед цифрами.
NumberStyles.AllowTrailingSign	Знак может появиться после цифр.
NumberStyles.AllowParentheses	Элемент sign в виде скобки, включающей числовое значение.
NumberStyles.AllowThousands	Элемент ,
NumberStyles.AllowCurrencySymbol	Элемент $ .

NumberStyles.AllowHexSpecifier Если флаг используется, s должен быть строковым представлением шестнадцатеричного значения без префикса. Например, синтаксический анализ 9AF3 выполняется успешно, но "0x9AF3" не выполняется. Единственные другие флаги, которые могут присутствовать в styleNumberStyles.AllowLeadingWhite них, и NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет составной стиль чисел, NumberStyles.HexNumberкоторый включает в себя оба флага пробела.)

Параметр provider — это IFormatProvider реализация, GetFormat метод которой получает NumberFormatInfo объект. Объект NumberFormatInfo предоставляет сведения о формате sязыка и региональных параметров. В provider противном nullNumberFormatInfo случае используется объект для текущего языка и региональных параметров.

См. также раздел

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Преобразует представление диапазона числа в указанном стиле и формате языка и региональных параметров в его 16-разрядное целое число со знаком.

public static short Parse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

public static short Parse(ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = default);

static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> int16

Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Short

Параметры

s: ReadOnlySpan<Char>

Диапазон, содержащий символы, представляющие число для преобразования.

style: NumberStyles

provider: IFormatProvider

Объект, предоставляющий IFormatProvider сведения о sформатировании, зависящие от языка и региональных параметров.

Возвращаемое значение

Int16

16-разрядное целое число со знаком, эквивалентное числу, указанному в s.

Реализации

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Анализирует диапазон символов UTF-8 в значение.

public static short Parse(ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

static member Parse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider -> int16

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As Short

Параметры

utf8Text: ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

style: NumberStyles

Побитовое сочетание стилей чисел, которые могут присутствовать в utf8Text.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от utf8Textязыка и региональных параметров.

Возвращаемое значение

Int16

Результат синтаксического анализа utf8Text.

Реализации

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

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

Parse(String, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Преобразует строковое представление числа в указанном формате языка и региональных параметров в его 16-разрядное целое число со знаком.

public:
 static short Parse(System::String ^ s, IFormatProvider ^ provider);

public:
 static short Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<short>::Parse;

public static short Parse(string s, IFormatProvider provider);

public static short Parse(string s, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> int16

Public Shared Function Parse (s As String, provider As IFormatProvider) As Short

Параметры

s: String

Строка, содержащая число для преобразования.

provider: IFormatProvider

Объект, предоставляющий IFormatProvider сведения о sформатировании, зависящие от языка и региональных параметров.

Возвращаемое значение

Int16

16-разрядное целое число со знаком, эквивалентное числу, указанному в s.

Реализации

Parse(String, IFormatProvider)

Исключения

ArgumentNullException

s равно null.

FormatException

s не соответствует правильному формату.

OverflowException

s представляет число меньше, чем Int16.MinValue или больше Int16.MaxValue.

Примеры

В следующем примере анализируется строковое представление значений Int16 с Int16.Parse(String, IFormatProvider) помощью метода.

string stringToConvert;
short number;

stringToConvert = " 214 ";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}

stringToConvert = " + 214";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}

stringToConvert = " +214 ";
try
{
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0'} is out of range of the Int16 data type.",
                     stringToConvert);
}
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214'.
//       Converted ' +214 ' to 214.

let stringToConvert = " 214 "
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with 
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

let stringToConvert = " + 214"
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with 
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException -> 
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

let stringToConvert = " +214 "
try
    let number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {number}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is out of range of the Int16 data type."

// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214'.
//       Converted ' +214 ' to 214.

Dim stringToConvert As String
Dim number As Short

stringToConvert = " 214 "
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try

stringToConvert = " + 214"                                 
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try

stringToConvert = " +214 " 
Try
   number = Int16.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0'} is out of range of the Int16 data type.", _
                     stringToConvert)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214'.
'       Converted ' +214 ' to 214.

Элемент	Описание
ws	Необязательный пробел.
знак	Необязательный знак.
Цифр	Последовательность цифр от 0 до 9.

Параметр s интерпретируется с помощью NumberStyles.Integer стиля. В дополнение к десятичным цифрам разрешены sтолько начальные и конечные пробелы вместе с начальным знаком. Чтобы явно определить элементы стиля вместе с сведениями о форматировании, зависящими от языка и региональных параметров, которые могут присутствовать в sметоде Int16.Parse(String, NumberStyles, IFormatProvider) .

Параметр provider — это IFormatProvider реализация, которая получает NumberFormatInfo объект. Предоставляет NumberFormatInfo сведения о формате sязыка и региональных параметров. Если provider это nullтак, NumberFormatInfo используется текущий язык и региональные параметры.

См. также раздел

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

Parse(String)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Преобразует строковое представление числа в 16-разрядное целое число со знаком.

public:
 static short Parse(System::String ^ s);

public static short Parse(string s);

static member Parse : string -> int16

Public Shared Function Parse (s As String) As Short

Параметры

s: String

Строка, содержащая число для преобразования.

Возвращаемое значение

Int16

16-разрядное целое число со знаком, эквивалентное числу, содержаемого в s.

Исключения

ArgumentNullException

s равно null.

FormatException

s не соответствует правильному формату.

OverflowException

s представляет число меньше, чем Int16.MinValue или больше Int16.MaxValue.

Примеры

В следующем примере показано, как преобразовать строковое значение в 16-разрядное целое число со знаком с помощью Int16.Parse(String) метода. После этого целочисленное значение отображается в консоли.

string value;
short number;

value = " 12603 ";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}

value = " 16,054";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}

value = " -17264";
try
{
   number = Int16.Parse(value);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException)
{
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.",
                     value);
}
// The example displays the following output to the console:
//       Converted ' 12603 ' to 12603.
//       Unable to convert ' 16,054' to a 16-bit signed integer.
//       Converted ' -17264' to -17264.

let value = " 12603 "
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}." 
with :? FormatException -> 
    printfn $"Unable to convert '{value}' to a 16-bit signed integer."

let value = " 16,054"
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn "Unable to convert '{value}' to a 16-bit signed integer."
                    
let value = " -17264"
try
    let number = Int16.Parse value
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn "Unable to convert '{value}' to a 16-bit signed integer."
    

// The example displays the following output to the console:
//       Converted ' 12603 ' to 12603.
//       Unable to convert ' 16,054' to a 16-bit signed integer.
//       Converted ' -17264' to -17264.

Dim value As String
Dim number As Short

value = " 12603 "
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try

value = " 16,054"
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try
                        
value = " -17264"
Try
   number = Short.Parse(value)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to convert '{0}' to a 16-bit signed integer.", _
                     value)
End Try
' The example displays the following output to the console:
'       Converted ' 12603 ' to 12603.
'       Unable to convert ' 16,054' to a 16-bit signed integer.
'       Converted ' -17264' to -17264.

Элемент	Описание
ws	Необязательный пробел.
знак	Необязательный знак.
Цифр	Последовательность цифр от 0 до 9.

Параметр s интерпретируется с помощью NumberStyles.Integer стиля. Помимо десятичных цифр целочисленного значения, допускаются только начальные и конечные пробелы вместе с начальным знаком. Чтобы явно определить элементы стиля, которые могут присутствовать s, используйте Int16.Parse(String, NumberStyles) метод или Parse метод.

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo , инициализированном для текущего языка и региональных параметров системы. Дополнительные сведения см. в разделе CurrentInfo. Чтобы проанализировать строку с помощью сведений о форматировании другого языка и региональных параметров, используйте Int16.Parse(String, IFormatProvider) метод или Int16.Parse(String, NumberStyles, IFormatProvider) метод.

См. также раздел

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Анализирует диапазон символов в значение.

public:
 static short Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<short>::Parse;

public static short Parse(ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> int16

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Short

Параметры

s: ReadOnlySpan<Char>

Диапазон символов для синтаксического анализа.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от sязыка и региональных параметров.

Возвращаемое значение

Int16

Результат синтаксического анализа s.

Реализации

Parse(ReadOnlySpan<Char>, IFormatProvider)

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

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Анализирует диапазон символов UTF-8 в значение.

public:
 static short Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<short>::Parse;

public static short Parse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

static member Parse : ReadOnlySpan<byte> * IFormatProvider -> int16

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Short

Параметры

utf8Text: ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от utf8Textязыка и региональных параметров.

Возвращаемое значение

Int16

Результат синтаксического анализа utf8Text.

Реализации

Parse(ReadOnlySpan<Byte>, IFormatProvider)

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

Parse(String, NumberStyles)

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Исходный код:: Int16.cs

Преобразует строковое представление числа в указанном стиле в его 16-разрядное целое число со знаком.

public:
 static short Parse(System::String ^ s, System::Globalization::NumberStyles style);

public static short Parse(string s, System.Globalization.NumberStyles style);

static member Parse : string * System.Globalization.NumberStyles -> int16

Public Shared Function Parse (s As String, style As NumberStyles) As Short

Параметры

s: String

Строка, содержащая число для преобразования.

style: NumberStyles

Возвращаемое значение

Int16

16-разрядное целое число со знаком, эквивалентное числу, указанному в s.

Исключения

ArgumentNullException

s равно null.

ArgumentException

style значение не является значением NumberStyles .

-или-

styleне является сочетанием значений и HexNumber значенийAllowHexSpecifier.

FormatException

s не соответствует формату, совместимом с style.

OverflowException

s представляет число меньше, чем Int16.MinValue или больше Int16.MaxValue.

-или-

s включает ненулевых дробных цифр.

Примеры

В следующем примере метод используется Int16.Parse(String, NumberStyles) для анализа строковых представлений значений Int16 с помощью языка и региональных параметров en-US.

using System;
using System.Globalization;

public class ParseSample
{
   public static void Main()
   {
      string value;
      NumberStyles style;

      // Parse a number with a thousands separator (throws an exception).
      value = "14,644";
      style = NumberStyles.None;
      ParseToInt16(value, style);

      style = NumberStyles.AllowThousands;
      ParseToInt16(value, style);

      // Parse a number with a thousands separator and decimal point.
      value = "14,644.00";
      style = NumberStyles.AllowThousands | NumberStyles.Integer |
              NumberStyles.AllowDecimalPoint;
      ParseToInt16(value, style);

      // Parse a number with a fractional component (throws an exception).
      value = "14,644.001";
      ParseToInt16(value, style);

      // Parse a number in exponential notation.
      value = "145E02";
      style = style | NumberStyles.AllowExponent;
      ParseToInt16(value, style);

      // Parse a number in exponential notation with a positive sign.
      value = "145E+02";
      ParseToInt16(value, style);

      // Parse a number in exponential notation with a negative sign
      // (throws an exception).
      value = "145E-02";
      ParseToInt16(value, style);
   }

   private static void ParseToInt16(string value, NumberStyles style)
   {
      try
      {
         short number = Int16.Parse(value, style);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to parse '{0}' with style {1}.", value,
                           style.ToString());
      }
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range of the Int16 type.", value);
      }
   }
}
// The example displays the following output to the console:
//       Unable to parse '14,644' with style None.
//       Converted '14,644' to 14644.
//       Converted '14,644.00' to 14644.
//       '14,644.001' is out of range of the Int16 type.
//       Converted '145E02' to 14500.
//       Converted '145E+02' to 14500.
//       '145E-02' is out of range of the Int16 type.

open System
open System.Globalization

let parseToInt16 (value: string) (style: NumberStyles) =
    try
        let number = Int16.Parse(value, style)
        printfn $"Converted '{value}' to {number}."
    with
    | :? FormatException ->
        printfn $"Unable to parse '{value}' with style {style}."
    | :? OverflowException ->
        printfn $"'{value}' is out of range of the Int16 type."

[<EntryPoint>]
let main _ =
    // Parse a number with a thousands separator (throws an exception).
    let value = "14,644"
    let style = NumberStyles.None
    parseToInt16 value style

    let style = NumberStyles.AllowThousands
    parseToInt16 value style

    // Parse a number with a thousands separator and decimal point.
    let value = "14,644.00"
    let style = NumberStyles.AllowThousands ||| NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    parseToInt16 value style

    // Parse a number with a fractional component (throws an exception).
    let value = "14,644.001"
    parseToInt16 value style

    // Parse a number in exponential notation.
    let value = "145E02"
    let style = style ||| NumberStyles.AllowExponent
    parseToInt16 value style

    // Parse a number in exponential notation with a positive sign.
    let value = "145E+02"
    parseToInt16 value style

    // Parse a number in exponential notation with a negative sign
    // (throws an exception).
    let value = "145E-02"
    parseToInt16 value style

    0

// The example displays the following output to the console:
//       Unable to parse '14,644' with style None.
//       Converted '14,644' to 14644.
//       Converted '14,644.00' to 14644.
//       '14,644.001' is out of range of the Int16 type.
//       Converted '145E02' to 14500.
//       Converted '145E+02' to 14500.
//       '145E-02' is out of range of the Int16 type.

Imports System.Globalization

Module ParseSample
   Public Sub Main()
      Dim value As String 
      Dim style As NumberStyles
      
      ' Parse a number with a thousands separator (throws an exception).
      value = "14,644"
      style = NumberStyles.None
      ParseToInt16(value, style)
      
      style = NumberStyles.AllowThousands
      ParseToInt16(value, style)
      
      ' Parse a number with a thousands separator and decimal point.
      value = "14,644.00"
      style = NumberStyles.AllowThousands Or NumberStyles.Integer Or _
              NumberStyles.AllowDecimalPoint
      ParseToInt16(value, style)
      
      ' Parse a number with a fractional component (throws an exception).
      value = "14,644.001"
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation.
      value = "145E02"
      style = style Or NumberStyles.AllowExponent
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation with a positive sign.
      value = "145E+02"
      ParseToInt16(value, style)
      
      ' Parse a number in exponential notation with a negative sign
      ' (throws an exception).
      value = "145E-02"
      ParseToInt16(value, style)
   End Sub
   
   Private Sub ParseToInt16(value As String, style As NumberStyles)
      Try
         Dim number As Short = Int16.Parse(value, style)
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to parse '{0}' with style {1}.", value, _
                           style.ToString())
      Catch e As OverflowException
         Console.WriteLine("'{0}' is out of range of the Int16 type.", value)
      End Try
   End Sub   
End Module
' The example displays the following output to the console:
'       Unable to parse '14,644' with style None.
'       Converted '14,644' to 14644.
'       Converted '14,644.00' to 14644.
'       '14,644.001' is out of range of the Int16 type.
'       Converted '145E02' to 14500.
'       Converted '145E+02' to 14500.
'       '145E-02' is out of range of the Int16 type.

Параметр style определяет элементы стиля (например, пробел или символ знака), которые разрешены в s параметре для успешной операции синтаксического анализа. Это должно быть сочетание битовых флагов из NumberStyles перечисления. В зависимости от значения styles параметр может включать следующие элементы:

[ws] [$] [знак] [цифры,]цифры[.fractional_digits][знак][знак][цифры][ws]

Или, если style включает AllowHexSpecifier:

[ws]hexdigits[ws]

Элементы в квадратных скобках ([ и ]) являются необязательными. В следующей таблице описан каждый элемент.

Элемент	Описание
ws	Необязательный пробел. Пробел может отображаться в начале `s` , если `style` он содержит NumberStyles.AllowLeadingWhite флаг, или в конце `s` , если `style` этот флаг включен NumberStyles.AllowTrailingWhite .
$	Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется и NumberFormatInfo.CurrencyPositivePattern свойствами NumberFormatInfo.CurrencyNegativePattern текущего языка и региональных параметров. Символ валюты текущего языка и региональных параметров может отображаться в `s` том случае, если `style` он включает NumberStyles.AllowCurrencySymbol флаг.
знак	Необязательный знак. Знак может отображаться в начале `s` , если `style` он включает NumberStyles.AllowLeadingSign флаг, и он может отображаться в конце `s` , если `style` он включает NumberStyles.AllowTrailingSign флаг. Скобки можно использовать для `s` указания отрицательного `style` значения, если NumberStyles.AllowParentheses он содержит флаг.
Цифр	Последовательность цифр от 0 до 9.
,	Символ разделителя тысяч, зависящих от языка и региональных параметров. Символ разделителя тысяч текущего языка и региональных параметров может отображаться в `s` том случае, если `style` он NumberStyles.AllowThousands содержит флаг.
.	Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой текущего языка и региональных параметров может отображаться при `sstyle` наличии флага NumberStyles.AllowDecimalPoint .
fractional_digits	Последовательность цифры 0. Дробные цифры могут отображаться при `sstyle` включении флага NumberStyles.AllowDecimalPoint . Если любое число, отличное от 0, отображается в fractional_digits, метод создает исключение OverflowException.
e	Символ E или E, указывающий, что `s` может быть представлено в экспоненциальной нотации. Параметр `s` может представлять число в экспоненциальной нотации, если `style` он включает NumberStyles.AllowExponent флаг. `s` Однако параметр должен представлять число в диапазоне Int16 типа данных и не может иметь ненулевых дробных компонентов.
hexdigits	Последовательность шестнадцатеричных цифр от 0 до f или 0 до F.

Заметка

Не составные значения NumberStyles	Элементы, разрешенные в s в дополнение к цифрам
NumberStyles.None	Только десятичные цифры.
NumberStyles.AllowDecimalPoint	Элементы . и fractional_digits . Однако fractional_digits должны состоять только из одного или нескольких 0 цифр или OverflowException создается.
NumberStyles.AllowExponent	Параметр `s` также может использовать экспоненциальную нотацию.
NumberStyles.AllowLeadingWhite	Элемент ws в начале `s`.
NumberStyles.AllowTrailingWhite	Элемент ws в конце `s`.
NumberStyles.AllowLeadingSign	Знак может появиться перед цифрами.
NumberStyles.AllowTrailingSign	Знак может появиться после цифр.
NumberStyles.AllowParentheses	Элемент sign в виде скобки, включающей числовое значение.
NumberStyles.AllowThousands	Элемент ,
NumberStyles.AllowCurrencySymbol	Элемент $ .

Параметр s анализируется с помощью сведений о форматировании в объекте NumberFormatInfo , инициализированном для текущего языка и региональных параметров системы. Дополнительные сведения см. в разделе NumberFormatInfo.CurrentInfo. Чтобы проанализировать s использование сведений о форматировании определенного языка и региональных параметров, вызовите Int16.Parse(String, NumberStyles, IFormatProvider) метод.

См. также раздел

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

Int16.Parse Метод

Определение

Перегрузки

Parse(String, NumberStyles, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Исключения

Примеры

Комментарии

См. также раздел

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

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

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

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

Parse(String, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Исключения

Примеры

Комментарии

См. также раздел

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

Parse(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

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

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

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

Parse(String, NumberStyles)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

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

Обратная связь