Convert::ToByte Method (String^)
Converts the specified string representation of a number to an equivalent 8-bit unsigned integer.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::String^
A string that contains the number to convert.
Return Value
Type: System::ByteAn 8-bit unsigned integer that is equivalent to value, or zero if value is null.
| Exception | Condition |
|---|---|
| FormatException | value does not consist of an optional sign followed by a sequence of digits (0 through 9). |
| OverflowException | value represents a number that is less than Byte::MinValue or greater than Byte::MaxValue. |
Using the ToByte(String^) method is equivalent to passing value to the Byte::Parse(String^) method. value is interpreted by using the formatting conventions of the current thread culture.
If you prefer not to handle an exception if the conversion fails, you can call the Byte::TryParse method instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.
The following example defines a string array and attempts to convert each string to a Byte. Note that while a null string parses to zero, String::Empty throws a FormatException. Also note that while leading and trailing spaces parse successfully, formatting symbols, such as currency symbols, group separators, or decimal separators, do not.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1