Convert::ToByte Method (Object^, IFormatProvider^)
Converts the value of the specified object to an 8-bit unsigned integer, using the specified culture-specific formatting information.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::Object^
An object that implements the IConvertible interface.
- provider
-
Type:
System::IFormatProvider^
An object that supplies culture-specific formatting information.
Return Value
Type: System::ByteAn 8-bit unsigned integer that is equivalent to value, or zero if value is null.
| Exception | Condition |
|---|---|
| FormatException | value is not in the property format for a Byte value. |
| InvalidCastException | |
| OverflowException | value represents a number that is less than Byte::MinValue or greater than Byte::MaxValue. |
provider enables the user to specify culture-specific conversion information about the contents of value. The base types ignore provider; however, the parameter may be used if value is a user-defined type that implements the IConvertible interface.
The following example defines a ByteString class that implements the IConvertible interface. The class stores the string representation of a byte value along with a sign field, so that it is able to represent both signed and unsigned byte values.
The following example instantiates several ByteString objects and calls the ToByte(Object^, IFormatProvider^) method to convert them to byte values. It illustrates that the ToByte(Object^, IFormatProvider^) method wraps a call to the IConvertible::ToByte method of the object to be converted.
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