Byte.Parse メソッド

定義

数値の文字列形式を、それと等価の Byte に変換します。Converts the string representation of a number to its Byte equivalent.

オーバーロード

Parse(String, NumberStyles, IFormatProvider)

指定したスタイルおよびカルチャ固有の書式の数値の文字列形式を、それと等価の Byte に変換します。Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

指定したスタイルおよびカルチャ固有の書式の数値のスパン表現を、それと等価の Byte に変換します。Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent.

Parse(String, NumberStyles)

指定のスタイルで表現された数値の文字列形式を、それと等価な Byte に変換します。Converts the string representation of a number in a specified style to its Byte equivalent.

Parse(String)

数値の文字列形式を、それと等価の Byte に変換します。Converts the string representation of a number to its Byte equivalent.

Parse(String, IFormatProvider)

指定されたカルチャ固有の書式で表現された文字列形式の数値を、それと等価の Byte に変換します。Converts the string representation of a number in a specified culture-specific format to its Byte equivalent.

Parse(String, NumberStyles, IFormatProvider)

指定したスタイルおよびカルチャ固有の書式の数値の文字列形式を、それと等価の Byte に変換します。Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
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

変換する数値を含んだ文字列。A string that contains a number to convert. 文字列は、style で指定されたスタイルを使用して解釈されます。The string is interpreted using the style specified by style.

style
NumberStyles

s で存在する可能性を持つスタイル要素を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the style elements that can be present in s. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

s の書式設定に関するカルチャ固有の情報を提供するオブジェクト。An object that supplies culture-specific information about the format of s. providernull の場合は、スレッドの現在のカルチャが使用されます。If provider is null, the thread current culture is used.

戻り値

Byte

s に格納されている数値と等価のバイト値。A byte value that is equivalent to the number contained in s.

例外

snullです。s is null.

s が正しい形式ではありません。s is not of the correct format.

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。s represents a number less than MinValue or greater than MaxValue.

- または --or-

s に 0 以外の小数部の桁が含まれています。s includes non-zero, fractional digits.

styleNumberStyles 値ではありません。style is not a NumberStyles value.

- または --or-

styleAllowHexSpecifier 値と HexNumber 値の組み合わせではありません。style is not a combination of AllowHexSpecifier and HexNumber values.

次のコード例では、 Byte メソッドのこのオーバーロードを使用して、値の文字列形式を解析し Byte.Parse(String, NumberStyles, IFormatProvider) ます。The following code example parses string representations of Byte values with this overload of the Byte.Parse(String, NumberStyles, IFormatProvider) method.

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.
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.
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 ます。The style parameter defines the style elements (such as white space or the positive sign) that are allowed in the s parameter for the parse operation to succeed. 列挙体のビットフラグの組み合わせである必要があり NumberStyles ます。It must be a combination of bit flags from the NumberStyles enumeration. の値に応じて style 、パラメーターには s 次の要素を含めることができます。Depending on the value of style, the s parameter may include the following elements:

jax-ws[$][sign] 数字 [.fractional_digits] [e [sign] digits] [ws][ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]

パラメーターに次の style ものが含まれている場合は、または AllowHexSpecifierOr, if the style parameter includes AllowHexSpecifier:

[ws] hexdigits [ws][ws]hexdigits[ws]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 省略可能な空白。Optional white space. にフラグが含まれている場合は、の先頭に空白が表示され s style NumberStyles.AllowLeadingWhite ます。または、の末尾にフラグが含まれている場合も s style NumberStyles.AllowTrailingWhite あります。White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. 文字列内での位置は、 NumberFormatInfo.CurrencyPositivePattern NumberFormatInfo パラメーターのメソッドによって返されるオブジェクトのプロパティによって定義され GetFormat provider ます。Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. s フラグが含まれている場合は、通貨記号がに表示され style NumberStyles.AllowCurrencySymbol ます。The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な正符号。An optional positive sign. ( OverflowException 負の符号がに存在する場合、メソッドはをスロー s します)。に s フラグが含まれている場合、 style NumberStyles.AllowLeadingSign またはの末尾にフラグが含まれている場合は、の先頭に符号が表示され s style NumberStyles.AllowTrailingSign ます。(The method throws an OverflowException if a negative sign is present in s.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, or at the end of s if style includes the NumberStyles.AllowTrailingSign flag.
数値digits 0から9までの一連の数字。A sequence of digits from 0 through 9.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. で指定されたカルチャの小数点の記号は、 provider にフラグが含まれている場合にで使用でき s style NumberStyles.AllowDecimalPoint ます。The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 数字0の1回以上の出現。One or more occurrences of the digit 0. にフラグが含まれている場合にのみ、に小数点以下の桁数が表示され s style NumberStyles.AllowDecimalPoint ます。Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee E または E 文字。値が指数表記で表されることを示します。The e or E character, which indicates that the value is represented in exponential notation. S パラメーターは、にフラグが含まれている場合に指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0から f、または0から F までの16進数のシーケンス。A sequence of hexadecimal digits from 0 through f, or 0 through F.

注意

の終端の NUL (U + 0000) 文字 s は、引数の値に関係なく、解析操作によって無視され style ます。Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

10進数の数字のみを含む文字列 (スタイルに対応) は、 NumberStyles.None 常に正常に解析されます。A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. 残りのメンバーのほとんどは、 NumberStyles この入力文字列に存在する必要があるが必須ではない要素を制御します。Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. 次の表は、の各メンバーが、に存在する可能性のある要素にどのように影響するかを示して NumberStyles s います。The following table indicates how individual NumberStyles members affect the elements that may be present in s.

非複合 NumberStyles 値Non-composite NumberStyles values 数字に加えてで許可される要素Elements permitted in s in addition to digits
NumberStyles.None 10進数のみ。Decimal digits only.
NumberStyles.AllowDecimalPoint .The . 要素と fractional_digits 要素。and fractional_digits elements. ただし、 fractional_digits は1桁以上の0桁で構成する必要があります。それ以外の場合は、 OverflowException がスローされます。However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent パラメーターでは、 s 指数表記を使用することもできます。The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite の先頭にある ws 要素 sThe ws element at the beginning of s.
NumberStyles.AllowTrailingWhite の末尾の ws 要素 sThe ws element at the end of s.
NumberStyles.AllowLeadingSign 正の符号は、 数字 の前に表示できます。A positive sign can appear before digits.
NumberStyles.AllowTrailingSign 正の記号は、 数字 の後に表示されます。A positive sign can appear after digits.
NumberStyles.AllowParentheses このフラグはサポートされていますが、でかっこを使用すると、になり s OverflowException ます。Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands には、桁区切り記号を含めることができ s ますが、先頭には1桁以上の0を付けることができます。Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol $ 要素。The $ element.

NumberStyles.AllowHexSpecifierフラグが使用されている場合、は s プレフィックスのない16進数の値である必要があります。If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. たとえば、"F3" は正常に解析されますが、"0xF3" は正常に解析されません。For example, "F3" parses successfully, but "0xF3" does not. 内に存在できるフラグは、とだけ style です NumberStyles.AllowLeadingWhite NumberStyles.AllowTrailingWhiteThe only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. ( NumberStyles 列挙体には、両方の空白フラグを含む複合数値スタイルがあり NumberStyles.HexNumber ます)。(The NumberStyles enumeration has a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

パラメーターは、 provider IFormatProvider NumberFormatInfo オブジェクトやオブジェクトなどの実装です CultureInfoThe provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. パラメーターは、 provider 解析に使用されるカルチャ固有の情報を提供します。The provider parameter supplies culture-specific information used in parsing. providernull の場合は、スレッドの現在のカルチャが使用されます。If provider is null, the thread current culture is used.

こちらもご覧ください

適用対象

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

指定したスタイルおよびカルチャ固有の書式の数値のスパン表現を、それと等価の Byte に変換します。Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent.

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>

変換する値を表す文字を含むスパン。A span containing the characters representing the value to convert.

style
NumberStyles

s で存在する可能性を持つスタイル要素を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the style elements that can be present in s. 通常指定する値は、Integer です。A typical value to specify is Integer.

provider
IFormatProvider

s の書式設定に関するカルチャ固有の情報を提供するオブジェクト。An object that supplies culture-specific information about the format of s. providernull の場合は、スレッドの現在のカルチャが使用されます。If provider is null, the thread current culture is used.

戻り値

Byte

s に格納されている数値と等価のバイト値。A byte value that is equivalent to the number contained in s.

適用対象

Parse(String, NumberStyles)

指定のスタイルで表現された数値の文字列形式を、それと等価な Byte に変換します。Converts the string representation of a number in a specified style to its Byte equivalent.

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

変換する数値を含んだ文字列。A string that contains a number to convert. 文字列は、style で指定されたスタイルを使用して解釈されます。The string is interpreted using the style specified by style.

style
NumberStyles

s で存在する可能性を持つスタイル要素を示す、列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that indicates the style elements that can be present in s. 通常指定する値は、Integer です。A typical value to specify is Integer.

戻り値

Byte

s に格納されている数値と等価のバイト値。A byte value that is equivalent to the number contained in s.

例外

snullです。s is null.

s が正しい形式ではありません。s is not of the correct format.

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。s represents a number less than MinValue or greater than MaxValue.

- または --or-

s に 0 以外の小数部の桁が含まれています。s includes non-zero, fractional digits.

styleNumberStyles 値ではありません。style is not a NumberStyles value.

- または --or-

styleAllowHexSpecifier 値と HexNumber 値の組み合わせではありません。style is not a combination of AllowHexSpecifier and HexNumber values.

次の例では Byte 、メソッドを使用して、値の文字列形式を解析し Byte.Parse(String, NumberStyles) ます。The following example parses string representations of Byte values with the Byte.Parse(String, NumberStyles) method. この例の現在のカルチャは en-us です。The current culture for the example is 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.
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.
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.

注釈

パラメーターは、 style 解析操作を成功させるためにパラメーターで使用できるスタイル要素 (空白や正符号など) を定義し s ます。The style parameter defines the style elements (such as white space or the positive sign) that are allowed in the s parameter for the parse operation to succeed. 列挙体のビットフラグの組み合わせである必要があり NumberStyles ます。It must be a combination of bit flags from the NumberStyles enumeration. の値に応じて style 、パラメーターには s 次の要素を含めることができます。Depending on the value of style, the s parameter may include the following elements:

jax-ws[$][sign] 数字 [.fractional_digits] [e [sign] digits] [ws][ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]

または、に style が含まれている場合 AllowHexSpecifier :Or, if style includes AllowHexSpecifier:

[ws] hexdigits [ws][ws]hexdigits[ws]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 省略可能な空白。Optional white space. にフラグが含まれている場合は、の先頭に空白が表示され s style NumberStyles.AllowLeadingWhite ます。また、style にフラグが含まれている場合は、の末尾にも使用でき NumberStyles.AllowTrailingWhite ます。White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, or at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ カルチャ固有の通貨記号。A culture-specific currency symbol. 文字列内での位置は、現在のカルチャのプロパティによって定義され NumberFormatInfo.CurrencyPositivePattern ます。Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the current culture. s フラグが含まれている場合は、現在のカルチャの通貨記号がに表示され style NumberStyles.AllowCurrencySymbol ます。The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign 省略可能な正符号。An optional positive sign. ( OverflowException 負の符号がに存在する場合、メソッドはをスロー s します)。に s フラグが含まれている場合、 style NumberStyles.AllowLeadingSign またはの末尾にフラグが含まれている場合は、の先頭に符号が表示され s style NumberStyles.AllowTrailingSign ます。(The method throws an OverflowException if a negative sign is present in s.) The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, or at the end of s if style includes the NumberStyles.AllowTrailingSign flag.
数値digits 0から9までの一連の数字。A sequence of digits from 0 through 9.
.. カルチャ固有の小数点の記号。A culture-specific decimal point symbol. s フラグが含まれている場合、現在のカルチャの小数点の記号がに表示され style NumberStyles.AllowDecimalPoint ます。The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.
fractional_digitsfractional_digits 数字0の1回以上の出現。One or more occurrences of the digit 0. にフラグが含まれている場合にのみ、に小数点以下の桁数が表示され s style NumberStyles.AllowDecimalPoint ます。Fractional digits can appear in s only if style includes the NumberStyles.AllowDecimalPoint flag.
ee E または E 文字。値が指数表記で表されることを示します。The e or E character, which indicates that the value is represented in exponential notation. s フラグが含まれている場合、パラメーターは指数表記で数値を表すことができ style NumberStyles.AllowExponent ます。The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits 0から f、または0から F までの16進数のシーケンス。A sequence of hexadecimal digits from 0 through f, or 0 through F.

注意

の終端の NUL (U + 0000) 文字 s は、引数の値に関係なく、解析操作によって無視され style ます。Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

10進数の数字のみを含む文字列 (スタイルに対応) は、 NumberStyles.None 常に正常に解析されます。A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully. 残りのメンバーのほとんどは、 NumberStyles この入力文字列に存在する必要があるが必須ではない要素を制御します。Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. 次の表は、の各メンバーが、に存在する可能性のある要素にどのように影響するかを示して NumberStyles s います。The following table indicates how individual NumberStyles members affect the elements that may be present in s.

非複合 NumberStyles 値Non-composite NumberStyles values 数字に加えてで許可される要素Elements permitted in s in addition to digits
NumberStyles.None 10進数のみ。Decimal digits only.
NumberStyles.AllowDecimalPoint .The . 要素と fractional_digits 要素。and fractional_digits elements. ただし、 fractional_digits は1桁以上の0桁で構成する必要があります。それ以外の場合は、 OverflowException がスローされます。However, fractional_digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent パラメーターでは、 s 指数表記を使用することもできます。The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite の先頭にある ws 要素 sThe ws element at the beginning of s.
NumberStyles.AllowTrailingWhite の末尾の ws 要素 sThe ws element at the end of s.
NumberStyles.AllowLeadingSign 正の符号は、 数字 の前に表示できます。A positive sign can appear before digits.
NumberStyles.AllowTrailingSign 正の記号は、 数字 の後に表示されます。A positive sign can appear after digits.
NumberStyles.AllowParentheses このフラグはサポートされていますが、でかっこを使用すると、になり s OverflowException ます。Although this flag is supported, the use of parentheses in s results in an OverflowException.
NumberStyles.AllowThousands には、桁区切り記号を含めることができ s ますが、先頭には1桁以上の0を付けることができます。Although the group separator symbol can appear in s, it can be preceded by only one or more 0 digits.
NumberStyles.AllowCurrencySymbol $ 要素。The $ element.

NumberStyles.AllowHexSpecifierフラグが使用されている場合、は s プレフィックスのない16進数の値である必要があります。If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. たとえば、"F3" は正常に解析されますが、"0xF3" は正常に解析されません。For example, "F3" parses successfully, but "0xF3" does not. 他のフラグと組み合わせて使用できるのは、 NumberStyles.AllowLeadingWhite とだけです NumberStyles.AllowTrailingWhiteThe only other flags that can be combined with it are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (列挙体には、 NumberStyles 両方の空白フラグを含む複合数値スタイルが含まれてい NumberStyles.HexNumber ます)。(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

パラメーターは、 s NumberFormatInfo 現在のシステムカルチャに対して初期化されたオブジェクトの書式情報を使用して解析されます。The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. 他のカルチャの書式設定情報を使用するには、オーバーロードを呼び出し Byte.Parse(String, NumberStyles, IFormatProvider) ます。To use the formatting information of some other culture, call the Byte.Parse(String, NumberStyles, IFormatProvider) overload.

こちらもご覧ください

適用対象

Parse(String)

数値の文字列形式を、それと等価の Byte に変換します。Converts the string representation of a number to its Byte equivalent.

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

変換する数値を含んだ文字列。A string that contains a number to convert. 文字列は、Integer スタイルを使用して解釈されます。The string is interpreted using the Integer style.

戻り値

Byte

s に格納されている数値と等価のバイト値。A byte value that is equivalent to the number contained in s.

例外

snullです。s is null.

s が正しい形式ではありません。s is not of the correct format.

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。s represents a number less than MinValue or greater than MaxValue.

次の例は、メソッドを使用して文字列値をバイト値に変換する方法を示して Byte.Parse(String) います。The following example demonstrates how to convert a string value into a byte value using the Byte.Parse(String) method. 結果のバイト値がコンソールに表示されます。The resulting byte value is then displayed to the console.

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.
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.
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.

注釈

パラメーターには、 s 次のような形式の数値が含まれています。The s parameter contains a number of the form:

jax-ws[sign] 数字 [ws][ws][sign]digits[ws]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 省略可能な空白。Optional white space.
signsign 省略可能な正または負の符号。An optional positive or negative sign.
数値digits 0から9までの一連の数字。A sequence of digits ranging from 0 to 9.

sパラメーターは、スタイルを使用して解釈され NumberStyles.Integer ます。The s parameter is interpreted using the NumberStyles.Integer style. バイト値の10進数に加えて、先頭と末尾のスペースのみが先頭の記号と共に使用できます。In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (符号が存在する場合は、正の記号であるか、またはメソッドがをスローする必要があり OverflowException ます)。で使用できるスタイル要素を明示的に定義するに s は、メソッドまたはメソッドを使用し Byte.Parse(String, NumberStyles) Byte.Parse(String, NumberStyles, IFormatProvider) ます。(If the sign is present, it must be a positive sign or the method throws an OverflowException.) To explicitly define the style elements that can be present in s, use either the Byte.Parse(String, NumberStyles) or the Byte.Parse(String, NumberStyles, IFormatProvider) method.

パラメーターは、 s NumberFormatInfo 現在のシステムカルチャに対して初期化されたオブジェクトの書式情報を使用して解析されます。The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. 詳細については、「CurrentInfo」を参照してください。For more information, see CurrentInfo. 他のカルチャの書式設定情報を使用して文字列を解析するには、メソッドを使用し Byte.Parse(String, NumberStyles, IFormatProvider) ます。To parse a string using the formatting information of some other culture, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.

こちらもご覧ください

適用対象

Parse(String, IFormatProvider)

指定されたカルチャ固有の書式で表現された文字列形式の数値を、それと等価の Byte に変換します。Converts the string representation of a number in a specified culture-specific format to its Byte equivalent.

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider);
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

変換する数値を含んだ文字列。A string that contains a number to convert. 文字列は、Integer スタイルを使用して解釈されます。The string is interpreted using the Integer style.

provider
IFormatProvider

s に関するカルチャ固有の解析情報を提供するオブジェクト。An object that supplies culture-specific parsing information about s. providernull の場合は、スレッドの現在のカルチャが使用されます。If provider is null, the thread current culture is used.

戻り値

Byte

s に格納されている数値と等価のバイト値。A byte value that is equivalent to the number contained in s.

例外

snullです。s is null.

s が正しい形式ではありません。s is not of the correct format.

s は、MinValue 未満の数値か、MaxValue より大きい数値を表します。s represents a number less than MinValue or greater than MaxValue.

次の例では Byte 、メソッドを使用して、値の文字列形式を解析し Parse ます。The following example parses string representations of Byte values with the Parse method.

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.
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.
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.

注釈

パラメーターには、 s 次のような形式の数値が含まれています。The s parameter contains a number of the form:

jax-ws[sign] 数字 [ws][ws][sign]digits[ws]

角かっこ ([ および ]) 内の要素は省略可能です。Elements in square brackets ([ and ]) are optional. 次の表は、それぞれの要素の説明です。The following table describes each element.

要素Element 説明Description
wsws 省略可能な空白。Optional white space.
signsign 省略可能な正符号。An optional positive sign.
数値digits 0から9までの一連の数字。A sequence of digits ranging from 0 to 9.

sパラメーターは、スタイルを使用して解釈され Integer ます。The s parameter is interpreted using the Integer style. バイト値の10進数に加えて、先頭と末尾のスペースのみが先頭の記号と共に使用できます。In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (符号が存在する場合は、正の記号であるか、またはメソッドがをスローする必要があり OverflowException ます)。で使用できるカルチャ固有の書式情報と共にスタイル要素を明示的に定義するには、 s メソッドを使用し Byte.Parse(String, NumberStyles, IFormatProvider) ます。(If the sign is present, it must be a positive sign or the method throws an OverflowException.) To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the Byte.Parse(String, NumberStyles, IFormatProvider) method.

sパラメーターは、によって提供されるオブジェクトの書式情報を使用して解析され NumberFormatInfo provider ます。The s parameter is parsed using the formatting information in a NumberFormatInfo object supplied by provider. パラメーターは、 provider IFormatProvider NumberFormatInfo オブジェクトやオブジェクトなどの実装です CultureInfoThe provider parameter is an IFormatProvider implementation such as a NumberFormatInfo or CultureInfo object. パラメーターは、 provider 解析に使用されるカルチャ固有の情報を提供します。The provider parameter supplies culture-specific information used in parsing. providernull の場合は、スレッドの現在のカルチャが使用されます。If provider is null, the thread current culture is used.

こちらもご覧ください

適用対象