Byte.Parse Метод

Определение

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

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

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

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

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

Преобразует строковое представление числа в его Byte эквивалент.

Перегрузки

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

Parse(String, NumberStyles, IFormatProvider)

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

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

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

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

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

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

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

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

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

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

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

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

Параметры

s: String

Строка, содержащая число для преобразования. Строка интерпретируется с помощью стиля, заданного .style

style: NumberStyles

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

provider: IFormatProvider

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

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

Byte

Байтовое значение, эквивалентное числу, содержаемого в s.

Реализации

Parse(String, NumberStyles, IFormatProvider)

Исключения

ArgumentNullException

s равно null.

FormatException

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

OverflowException

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

–или–

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

ArgumentException

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

–или–

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

Примеры

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

NumberStyles style;
CultureInfo culture;
string value;
byte number;

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo.CreateSpecificCulture("en-GB");
try
{
   number = Byte.Parse(value, style, culture);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

value = "12.000";
number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
let style = NumberStyles.Float
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
let value = "12,000"

let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {number}."

let culture = CultureInfo.CreateSpecificCulture "en-GB"
try
    let number = Byte.Parse(value, style, culture)
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

let value = "12.000"
let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {number}."

// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.

Dim style As NumberStyles
Dim culture As CultureInfo
Dim value As String
Dim number As Byte

' Parse number with decimals.
' NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float       
culture = CultureInfo.CreateSpecificCulture("fr-FR")
value = "12,000"

number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

culture = CultureInfo.CreateSpecificCulture("en-GB")
Try
   number = Byte.Parse(value, style, culture)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try      

value = "12.000"
number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' The example displays the following output to the console:
'       Converted '12,000' to 12.
'       Unable to parse '12,000'.
'       Converted '12.000' to 12.

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

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

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

[ws]hexdigits[ws]

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

Элемент	Описание
ws	Необязательный пробел. Пробел может отображаться в начале `s` , если `style` он содержит NumberStyles.AllowLeadingWhite флаг, или в конце `s` , если `style` этот флаг включен NumberStyles.AllowTrailingWhite .
$	Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется NumberFormatInfo.CurrencyPositivePattern свойством NumberFormatInfo объекта, возвращаемого GetFormat методом `provider` параметра. Символ валюты может отображаться в `s` том случае, если `style` он включает NumberStyles.AllowCurrencySymbol флаг.
знак	Необязательный положительный знак. (Метод вызывает исключение, если отрицательный OverflowException знак присутствует в `s`.) Знак может появиться в начале `s` , если `style` он включает NumberStyles.AllowLeadingSign флаг или в конце `s` , если `style` этот флаг включен NumberStyles.AllowTrailingSign .
Цифр	Последовательность цифр от 0 до 9.
.	Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой языка и региональных параметров, указанный в `provider` нем, может отображаться в `s` том случае, если `style` он NumberStyles.AllowDecimalPoint содержит флаг.
fractional_digits	Одно или несколько вхождений цифры 0. Дробные цифры могут отображаться только в `s` том случае, если `style` он содержит NumberStyles.AllowDecimalPoint флаг.
e	Символ e или E, указывающий, что значение представлено в экспоненциальной нотации. Параметр s может представлять число в экспоненциальной нотации, если `style` он включает NumberStyles.AllowExponent флаг.
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	Хотя этот флаг поддерживается, использование круглых скобок `s` приводит к OverflowExceptionиспользованию.
NumberStyles.AllowThousands	Хотя символ разделителя групп может отображаться в `s`, он может предшествовать только одному или нескольким цифрам 0.
NumberStyles.AllowCurrencySymbol	Элемент $ .

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

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

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

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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

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

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

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

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

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

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

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

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

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

Параметры

s: ReadOnlySpan<Char>

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

style: NumberStyles

provider: IFormatProvider

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

Byte

Байтовое значение, эквивалентное числу, содержаемого в s.

Реализации

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

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

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

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

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

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

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

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

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

Параметры

utf8Text: ReadOnlySpan<Byte>

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

style: NumberStyles

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

provider: IFormatProvider

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

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

Byte

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

Реализации

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

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

Parse(String, IFormatProvider)

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

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

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

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

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

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

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

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

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

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

static member Parse : string * IFormatProvider -> byte

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

Параметры

s: String

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

provider: IFormatProvider

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

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

Byte

Байтовое значение, эквивалентное числу, содержаемого в s.

Реализации

Parse(String, IFormatProvider)

Исключения

ArgumentNullException

s равно null.

FormatException

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

OverflowException

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

Примеры

В следующем примере анализируется строковое представление значений Byte с Parse помощью метода.

string stringToConvert;
byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }
// 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 byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " + 214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " +214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

// 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 byteValue As Byte

stringToConvert = " 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " + 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " +214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
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 интерпретируется с помощью Integer стиля. Помимо десятичных цифр байтов, допускаются только начальные и конечные пробелы вместе с начальным знаком. (Если знак присутствует, это должен быть положительный знак или метод вызывает OverflowException.) Чтобы явно определить элементы стиля вместе с сведениями о форматировании, зависящими от языка и региональных параметров, которые могут присутствовать в sметоде Byte.Parse(String, NumberStyles, IFormatProvider) .

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

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

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

Parse(String, NumberStyles)

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

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

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

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

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

Преобразует строковое представление числа в указанном стиле в его Byte эквивалент.

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

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

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

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

Параметры

s: String

Строка, содержащая число для преобразования. Строка интерпретируется с помощью стиля, заданного .style

style: NumberStyles

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

Byte

Значение байта, эквивалентное числу, содержаемого в s.

Исключения

ArgumentNullException

s равно null.

FormatException

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

OverflowException

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

–или–

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

ArgumentException

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

–или–

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

Примеры

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

string value;
NumberStyles style;
byte number;

// Parse value with no styles allowed.
style = NumberStyles.None;
value = " 241 ";
try
{
   number = Byte.Parse(value, style);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

// Parse value with trailing sign.
style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
value = " 163+";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

// Parse value with no styles allowed.
let style = NumberStyles.None
let value = " 241 "
try
    let number = Byte.Parse(value, style);
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

// Parse value with trailing sign.
let style = NumberStyles.Integer ||| NumberStyles.AllowTrailingSign
let value = " 163+"
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// Parse value with leading sign.
let value = "   +253  "
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

Dim value As String
Dim style As NumberStyles
Dim number As Byte

' Parse value with no styles allowed.
style = NumberStyles.None
value = " 241 "
Try
   number = Byte.Parse(value, style)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try
  
' Parse value with trailing sign.
style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
value = " 163+"
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

' Parse value with leading sign.
value = "   +253  "
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' This example displays the following output to the console:
'       Unable to parse ' 241 '.
'       Converted ' 163+' to 163.
'       Converted '   +253  ' to 253.

Элемент	Описание
ws	Необязательный пробел. Пробел может отображаться в начале `s` , если `style` флаг включен NumberStyles.AllowLeadingWhite или в конце s, если стиль включает NumberStyles.AllowTrailingWhite флаг.
$	Символ валюты, зависящий от языка и региональных параметров. Его положение в строке определяется свойством NumberFormatInfo.CurrencyPositivePattern текущего языка и региональных параметров. Символ валюты текущего языка и региональных параметров может отображаться в `s` том случае, если `style` он включает NumberStyles.AllowCurrencySymbol флаг.
знак	Необязательный положительный знак. (Метод вызывает исключение, если отрицательный OverflowException знак присутствует в `s`.) Знак может появиться в начале `s` , если `style` он включает NumberStyles.AllowLeadingSign флаг или в конце `s` , если `style` этот флаг включен NumberStyles.AllowTrailingSign .
Цифр	Последовательность цифр от 0 до 9.
.	Символ десятичной запятой для конкретного языка и региональных параметров. Символ десятичной запятой текущего языка и региональных параметров может отображаться при `sstyle` наличии флага NumberStyles.AllowDecimalPoint .
fractional_digits	Одно или несколько вхождений цифры 0. Дробные цифры могут отображаться только в `s` том случае, если `style` он содержит NumberStyles.AllowDecimalPoint флаг.
e	Символ e или E, указывающий, что значение представлено в экспоненциальной нотации. Параметр `s` может представлять число в экспоненциальной нотации, если `style` он включает NumberStyles.AllowExponent флаг.
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	Хотя этот флаг поддерживается, использование круглых скобок `s` приводит к OverflowExceptionиспользованию.
NumberStyles.AllowThousands	Хотя символ разделителя групп может отображаться в `s`, он может предшествовать только одному или нескольким цифрам 0.
NumberStyles.AllowCurrencySymbol	Элемент $ .

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

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

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

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

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

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

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

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

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

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

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

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

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

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

Параметры

s: ReadOnlySpan<Char>

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

provider: IFormatProvider

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

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

Byte

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

Реализации

Parse(ReadOnlySpan<Char>, IFormatProvider)

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

Parse(ReadOnlySpan<Byte>, IFormatProvider)

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

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

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

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

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

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

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

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

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

Параметры

utf8Text: ReadOnlySpan<Byte>

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

provider: IFormatProvider

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

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

Byte

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

Реализации

Parse(ReadOnlySpan<Byte>, IFormatProvider)

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

Parse(String)

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

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

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

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

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

Преобразует строковое представление числа в его Byte эквивалент.

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

public static byte Parse(string s);

static member Parse : string -> byte

Public Shared Function Parse (s As String) As Byte

Параметры

s: String

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

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

Byte

Байтовое значение, эквивалентное числу, содержаемого в s.

Исключения

ArgumentNullException

s равно null.

FormatException

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

OverflowException

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

Примеры

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

string stringToConvert = " 162";
byte byteValue;
try
{
   byteValue = Byte.Parse(stringToConvert);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue);
}
// The example displays the following output to the console:
//       Converted ' 162' to 162.

let stringToConvert = " 162"
try
    let byteValue = Byte.Parse stringToConvert
    printfn $"Converted '{stringToConvert}' to {byteValue}."
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}."

// The example displays the following output to the console:
//       Converted ' 162' to 162.

Dim stringToConvert As String = " 162"
Dim byteValue As Byte
Try
   byteValue = Byte.Parse(stringToConvert)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  
' The example displays the following output to the console:
'       Converted ' 162' to 162.

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

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

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

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

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

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

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

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

Byte.Parse Метод

Определение

Перегрузки

Parse(String, NumberStyles, IFormatProvider)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Параметры

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

Реализации

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

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Параметры

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

Реализации

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

Parse(String, IFormatProvider)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

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

Parse(String, NumberStyles)

Параметры

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

Исключения

Примеры

Комментарии

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

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

Параметры

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

Реализации

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

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Параметры

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

Реализации

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

Parse(String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

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