Int16.TryParse Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
Перегрузки
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16) |
Пытается проанализировать диапазон символов UTF-8 в значение. |
TryParse(ReadOnlySpan<Char>, Int16) |
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование. |
TryParse(String, Int16) |
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16) |
Пытается проанализировать диапазон символов в значение. |
TryParse(String, IFormatProvider, Int16) |
Пытается проанализировать строку в значение. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16) |
Пытается проанализировать диапазон символов UTF-8 в значение. |
TryParse(ReadOnlySpan<Byte>, Int16) |
Пытается преобразовать диапазон символов UTF-8, содержащий строковое представление числа, в эквивалентное 16-битовое целое число со знаком. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int16) |
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование. |
TryParse(String, NumberStyles, IFormatProvider, Int16) |
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Пытается проанализировать диапазон символов UTF-8 в значение.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IUtf8SpanParsable<short>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As Short) As Boolean
Параметры
- utf8Text
- ReadOnlySpan<Byte>
Диапазон символов UTF-8 для анализа.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра utf8Text
в зависимости от языка и региональных параметров.
- result
- Int16
При возврате содержит результат успешного анализа utf8Text
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если utf8Text
был успешно проанализирован; в противном случае — значение false
.
Применяется к
TryParse(ReadOnlySpan<Char>, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
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>
Диапазон, содержащий символы, которые представляют преобразуемое число.
- result
- Int16
При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s
, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей. Преобразование завершается ошибкой s
, если параметр имеет значение null
или Empty, не имеет формат, совместимый с style
, или представляет число меньше , чем Int16.MinValue или больше Int16.MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result
, будет перезаписано.
Возвращаемое значение
Значение true
, если параметр s
успешно преобразован; в противном случае — значение false
.
Применяется к
TryParse(String, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Преобразует строковое представление числа в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (string s, 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
Строка, содержащая преобразуемое число.
- result
- Int16
При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s
, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей. Преобразование завершается ошибкой s
, если параметр имеет значение null
или Empty, имеет неправильный формат или представляет число меньше Int16.MinValue или больше Int16.MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result
, будет перезаписано.
Возвращаемое значение
Значение true
, если параметр s
успешно преобразован; в противном случае — значение false
.
Примеры
В следующем примере вызывается Int16.TryParse(String, Int16) метод с несколькими различными строковыми значениями.
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.
open System
let tryToParse (value: string) =
match Int16.TryParse value with
| true, number -> printfn "Converted '{value}' to {number}."
| _ ->
let value = if isNull value then "" else value
printfn $"Attempted conversion of '{value}' failed."
tryToParse null
tryToParse "16051"
tryToParse "9432.0"
tryToParse "16,667"
tryToParse " -322 "
tryToParse "+4302"
tryToParse "(100);"
tryToParse "01FA"
// 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) метод не может преобразовать в этом примере:
"9432.0". Преобразование завершается ошибкой, так как строка не может содержать десятичный разделитель; он должен содержать только целочисленные цифры.
"16,667". Преобразование завершается ошибкой, так как строка не может содержать разделители групп; он должен содержать только целочисленные цифры.
"(100)". Преобразование завершается ошибкой, так как строка не может содержать отрицательный знак, отличный от того, который определен свойствами и текущими языками и NumberFormatInfo.NumberNegativePattern региональными параметрамиNumberFormatInfo.NegativeSign.
"01FA". Преобразование завершается ошибкой, так как строка не может содержать шестнадцатеричные цифры; он должен содержать только десятичные цифры.
Комментарии
Метод Int16.TryParse(String, Int16) отличается от Int16.Parse(String) метода тем, что возвращает логическое значение, указывающее, успешно ли выполнена операция синтаксического анализа, а не возвращает проанализированное Int16 значение. Это избавляет от необходимости использовать обработку исключений FormatException для проверки на наличие в случае, s
если он является недопустимым и не может быть успешно проанализирован.
Параметр s
должен представлять собой строковое представление числа в формате :
[ws] [sign]digits[ws]
Элементы в квадратных скобках ([ и ]) являются необязательными. Каждый из элементов описан в таблице ниже.
Элемент | Описание |
---|---|
ws | Необязательный пробел. |
sign | Необязательный знак. |
digits | Последовательность цифр в диапазоне от 0 до 9. |
Параметр s
интерпретируется с помощью NumberStyles.Integer стиля . Помимо десятичных цифр, допускаются только начальные и конечные пробелы вместе со знаком "в начале". Чтобы явно определить элементы стиля вместе со сведениями о форматировании для конкретного языка и региональных параметров, которые могут присутствовать в s
, используйте Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) метод .
Параметр s
анализируется с помощью сведений о форматировании в объекте NumberFormatInfo , инициализированном для текущего системного языка и региональных параметров. Для получения дополнительной информации см. CurrentInfo.
Эта перегрузка TryParse метода интерпретирует все цифры в параметре s
как десятичные. Чтобы проанализировать строковое представление шестнадцатеричного числа, вызовите перегрузку Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) .
См. также раздел
- Parse(String)
- ToString()
- Синтаксический анализ числовых строк в .NET
- Пример: служебная программа форматирования .NET Core WinForms (C#)
- Пример: служебная программа форматирования .NET Core WinForms (Visual Basic)
Применяется к
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Пытается проанализировать диапазон символов в значение.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = ISpanParsable<short>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Short) As Boolean
Параметры
- s
- ReadOnlySpan<Char>
Диапазон символов для анализа.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Int16
При возврате этого метода содержит результат успешного анализа s
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если s
был успешно проанализирован; в противном случае — значение false
.
Применяется к
TryParse(String, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Пытается проанализировать строку в значение.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = IParsable<short>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out short result);
static member TryParse : string * IFormatProvider * int16 -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Short) As Boolean
Параметры
- s
- String
Строка для анализа.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Int16
При возврате этого метода содержит результат успешного анализа s
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если s
был успешно проанализирован; в противном случае — значение false
.
Применяется к
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Пытается проанализировать диапазон символов UTF-8 в значение.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out short result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As Short) As Boolean
Параметры
- utf8Text
- ReadOnlySpan<Byte>
Диапазон символов UTF-8 для анализа.
- style
- NumberStyles
Побитовое сочетание стилей чисел, которые могут присутствовать в utf8Text
.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра utf8Text
в зависимости от языка и региональных параметров.
- result
- Int16
При возврате содержит результат успешного анализа utf8Text
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если utf8Text
был успешно проанализирован; в противном случае — значение false
.
Применяется к
TryParse(ReadOnlySpan<Byte>, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Пытается преобразовать диапазон символов UTF-8, содержащий строковое представление числа, в эквивалентное 16-разрядное целое число со знаком.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] short % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out short result);
static member TryParse : ReadOnlySpan<byte> * int16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Short) As Boolean
Параметры
- utf8Text
- ReadOnlySpan<Byte>
Диапазон, содержащий символы UTF-8, представляющие число для преобразования.
- result
- Int16
При возврате этим методом содержит 16-разрядное целое число со знаком, эквивалентное числу, содержамого в utf8Text
, если преобразование выполнено успешно, или ноль, если преобразование завершилось неудачно. Этот параметр передается неинициализированным. Любое значение, первоначально предоставленное в результате, будет перезаписано.
Возвращаемое значение
Значение true
, если параметр utf8Text
успешно преобразован; в противном случае — значение false
.
Применяется к
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Преобразует представление числа в виде диапазона в указанном стиле и формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
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, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, 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>
Диапазон, содержащий символы, которые представляют преобразуемое число. Диапазон интерпретируется с использованием стиля, указанного в style
.
- style
- NumberStyles
Побитовое сочетание значений перечисления, обозначающих элементы стиля, которые могут быть представлены в параметре s
. Обычно указывается значение Integer.
- provider
- IFormatProvider
Объект, который предоставляет сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Int16
При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s
, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей. Преобразование завершается ошибкой s
, если параметр имеет значение null
или Empty, не соответствует формату style
или представляет число меньше Int16.MinValue или больше Int16.MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result
, будет перезаписано.
Возвращаемое значение
Значение true
, если параметр s
успешно преобразован; в противном случае — значение false
.
Применяется к
TryParse(String, NumberStyles, IFormatProvider, Int16)
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
- Исходный код:
- Int16.cs
Преобразует строковое представление числа в формате, соответствующем языку и региональным параметрам, в эквивалентное ему 16-битовое целое число со знаком. Возвращает значение, указывающее, успешно ли выполнено преобразование.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] short % result) = System::Numerics::INumberBase<short>::TryParse;
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, 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
Строка, содержащая преобразуемое число. Строка интерпретируется с использованием стиля, указанного в style
.
- style
- NumberStyles
Побитовое сочетание значений перечисления, обозначающих элементы стиля, которые могут быть представлены в параметре s
. Обычно указывается значение Integer.
- provider
- IFormatProvider
Объект, который предоставляет сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Int16
При возвращении этим методом содержит 16-битное целочисленное значение со знаком, эквивалентное числу, содержащемуся в параметре s
, если преобразование выполнено успешно, или нуль, если оно завершилось неудачей. Преобразование завершается ошибкой s
, если параметр имеет значение null
или Empty, не соответствует формату style
или представляет число меньше Int16.MinValue или больше Int16.MaxValue. Этот параметр передается неинициализированным; любое значение, первоначально предоставленное в result
, будет перезаписано.
Возвращаемое значение
Значение true
, если параметр s
успешно преобразован; в противном случае — значение false
.
Исключения
style
не является значением NumberStyles.
-или-
style
не является сочетанием значений AllowHexSpecifier и HexNumber.
Примеры
В следующем примере вызывается Int16.TryParse(String, NumberStyles, IFormatProvider, Int16) метод с несколькими различными строковыми значениями.
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 '{stringToConvert}' to {number}.");
else
Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
}
}
// 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.
open System
open System.Globalization
let callTryParse (stringToConvert: string) (styles: NumberStyles) =
match Int16.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
| true, number ->
printfn $"Converted '{stringToConvert}' to {number}."
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
[<EntryPoint>]
let main _ =
let numericString = "10677"
let styles = NumberStyles.Integer
callTryParse numericString styles
let numericString = "-30677"
let styles = NumberStyles.None
callTryParse numericString styles
let numericString = "10345.00"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "10345.72";
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "22,593"
let styles = NumberStyles.Integer ||| NumberStyles.AllowThousands
callTryParse numericString styles
let numericString = "12E-01"
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse numericString styles
let numericString = "12E03"
callTryParse numericString styles
let numericString = "80c1"
callTryParse numericString NumberStyles.HexNumber
let numericString = "0x80C1"
callTryParse numericString NumberStyles.HexNumber
0
// 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 значение. Это избавляет от необходимости использовать обработку исключений FormatException для тестирования в случае, если s
он является недопустимым и не может быть успешно проанализирован.
Параметр style
определяет элементы стиля (например, пробелы или положительный или отрицательный знак), которые разрешены в s
параметре для успешного выполнения операции синтаксического анализа. Это должно быть сочетание битовых флагов из перечисления NumberStyles . В зависимости от значения стиля s
параметр может включать следующие элементы:
[ws] [$] [знак] [цифры,]digits[.fractional_digits][e[sign]digits][ws]
Или, если style
параметр включает NumberStyles.AllowHexSpecifier:
[ws]hexdigits[ws]
Элементы в квадратных скобках ([ и ]) являются необязательными. Каждый из элементов описан в таблице ниже.
Элемент | Описание |
---|---|
ws | Необязательный пробел. Пробел может отображаться в начале s , если style включает NumberStyles.AllowLeadingWhite флаг, или в конце s , если style включает NumberStyles.AllowTrailingWhite флаг. |
$ | Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется свойством CurrencyPositivePattern объекта, NumberFormatInfo возвращаемого GetFormat методом provider параметра . Символ валюты может отображаться в , s если style включает NumberStyles.AllowCurrencySymbol флаг . |
sign | Необязательный знак. |
digits | Последовательность цифр от 0 до 9. |
, | Разделитель тысяч, зависящий от языка и региональных параметров. Разделитель тысяч для языка и региональных параметров, заданных параметром , provider может отображаться в s , если style включает флаг NumberStyles.AllowThousands . |
. | Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой языка и региональных параметров, заданных параметром provider , может отображаться в s , если style включает флаг NumberStyles.AllowDecimalPoint . |
fractional_digits | Одно или несколько вхождений цифры 0. Дробные цифры могут отображаться в s , только если style включает NumberStyles.AllowDecimalPoint флаг . |
e | Символ "e" или "E", который указывает, что значение представлено в экспоненциальной нотации. Параметр s может представлять число в экспоненциальной нотации, если style включает флаг NumberStyles.AllowExponent . |
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, или метод возвращает false . |
NumberStyles.AllowExponent | Параметр s также может использовать экспоненциальную нотацию. Если s представляет число в экспоненциальной нотации, оно должно представлять целое число в диапазоне Int16 типа данных без ненулевого дробного компонента. |
NumberStyles.AllowLeadingWhite | Элемент ws в начале s. |
NumberStyles.AllowTrailingWhite | Элемент ws в конце s. |
NumberStyles.AllowLeadingSign | Знак может отображаться перед цифрами. |
NumberStyles.AllowTrailingSign | Знак может отображаться после цифр. |
NumberStyles.AllowParentheses | Элемент sign в виде круглых скобок, включающих числовое значение. |
NumberStyles.AllowThousands | Элемент , . |
NumberStyles.AllowCurrencySymbol | Элемент $. |
NumberStyles.Currency | Все элементы. Параметр s не может представлять шестнадцатеричное число или число в экспоненциальной нотации. |
NumberStyles.Float | Элемент ws в начале или конце s , знак в начале s и символ . Параметр s также может использовать экспоненциальную нотацию. |
NumberStyles.Number | Элементы ws, знак, разделитель тысяч (,) и десятичная запятая (.). |
NumberStyles.Any | Все стили, кроме s не могут представлять шестнадцатеричное число. |
NumberStyles.AllowHexSpecifier Если флаг используется, s
должно быть шестнадцатеричным значением без префикса. Например, "9AF3" анализирует успешно, а "0x9AF3" — нет. Единственными флагами, которые могут присутствовать в style
, являются NumberStyles.AllowLeadingWhite и NumberStyles.AllowTrailingWhite. (Перечисление NumberStyles имеет составной стиль NumberStyles.HexNumber, который включает оба флага пробелов.)
Параметр provider
является реализацией IFormatProvider , такой как CultureInfo объект или NumberFormatInfo объект , метод которого GetFormat возвращает NumberFormatInfo объект . Объект NumberFormatInfo предоставляет сведения о формате s
. Если provider
имеет значение null
, NumberFormatInfo используется объект для текущего языка и региональных параметров.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по