Int16.Parse Метод

Ссылка

Определение

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

Сборка:: 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

Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 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 не является сочетанием значений AllowHexSpecifier и HexNumber.

FormatException

s не представлен в формате, совместимом с style.

OverflowException

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

-или-

s содержит ненулевые дробные цифры.

Примеры

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

String^ value;
Int16 number;
NumberStyles style;

// Parse string using "." as the thousands separator 
// and " " as the decimal separator.
value = "19 694,00";
style = NumberStyles::AllowDecimalPoint | NumberStyles::AllowThousands;
CultureInfo^ provider = gcnew 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 ^e)
{
   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 = gcnew CultureInfo("en-GB");

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

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 . В зависимости от значения styleпараметр s может включать следующие элементы:

[ws] [$] [sign] [digits,]digits[.fractional_digits][e[sign]digits][ws]

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

[ws]hexdigits[ws]

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

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

Примечание

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

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

Несочетаемые значения NumberStyles	Элементы, разрешенные в , в дополнение к цифрам
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" — нет. Единственными флагами, которые могут присутствовать в style , являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет стиль составных чисел , NumberStyles.HexNumberкоторый включает оба флага пробелов.)

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

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

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Исходный код:: 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

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

Int16

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

Реализации

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Исходный код:: 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

Преобразует строковое представление числа в указанном формате, соответствующем языку и региональным параметрам, в эквивалентное ему 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

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

Int16

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

Реализации

Parse(String, IFormatProvider)

Исключения

ArgumentNullException

s имеет значение null.

FormatException

s имеет неправильный формат.

OverflowException

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

Примеры

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

String^ stringToConvert;
Int16 number;

stringToConvert = " 214 ";
try
{
   number = Int16::Parse(stringToConvert, CultureInfo::InvariantCulture);
   Console::WriteLine("Converted '{0}' to {1}.", stringToConvert, number);
}
catch (FormatException ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   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 ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   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 ^e)
{
   Console::WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException ^e)
{
   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.

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	Необязательный пробел.
sign	Необязательный знак.
digits	Последовательность цифр в диапазоне от 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

Преобразует строковое представление числа в эквивалентное ему 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;
Int16 number;
   
value = " 12603 ";
try
{
   number = Int16::Parse(value);
   Console::WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException ^e)
{
   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 ^e)
{
   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 ^e)
{
   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.

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	Необязательный пробел.
sign	Необязательный знак.
digits	Последовательность цифр в диапазоне от 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

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

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

Анализирует диапазон символов 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

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

Int16

Результат анализа utf8Text.

Реализации

Parse(ReadOnlySpan<Byte>, IFormatProvider)

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

Parse(String, NumberStyles)

Исходный код:: 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 не является сочетанием значений AllowHexSpecifier и HexNumber.

FormatException

s не представлен в формате, совместимом с style.

OverflowException

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

-или-

s содержит ненулевые дробные цифры.

Примеры

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

using namespace System;
using namespace System::Globalization;

ref 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;
      ParseSample::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
      {
         Int16 number = Int16::Parse(value, style);
         Console::WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException ^e)
      {
         Console::WriteLine("Unable to parse '{0}' with style {1}.", value, 
                            style);
      }
      catch (OverflowException ^e)
      {
         Console::WriteLine("'{0}' is out of range of the Int16 type.", value);
      }
   }
};

int main()
{
    ParseSample::Main();
    Console::ReadLine();
    return 0;
}
// The example displays the following output:
//       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.

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 . В зависимости от значения styleпараметр s может включать следующие элементы:

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

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

[ws]hexdigits[ws]

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

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

Примечание

Несочетаемые значения NumberStyles	Элементы, разрешенные в , в дополнение к цифрам
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)

Параметры

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

Исключения

Примеры

Комментарии

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

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

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

Дополнительные ресурсы