Byte::Parse Method (String^)


Converts the string representation of a number to its Byte equivalent.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

static unsigned char Parse(
	String^ s


Type: System::String^

A string that contains a number to convert. The string is interpreted using the Integer style.

Return Value

Type: System::Byte

A byte value that is equivalent to the number contained in s.

Exception Condition

s is null.


s is not of the correct format.


s represents a number less than MinValue or greater than MaxValue.

The s parameter contains a number of the form:


Elements in square brackets ([ and ]) are optional. The following table describes each element.




Optional white space.


An optional positive or negative sign.


A sequence of digits ranging from 0 to 9.

The s parameter is interpreted using the NumberStyles::Integer style. In addition to the byte value's decimal digits, only leading and trailing spaces together with a leading sign are allowed. (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.

The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. For more information, see CurrentInfo. To parse a string using the formatting information of some other culture, use the Byte::Parse(String^, NumberStyles, IFormatProvider^) method.

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top