Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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.

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

public:
static unsigned char ToByte(
	Object^ value,
	IFormatProvider^ provider
)

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::Byte

An 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

value does not implement IConvertible.

-or-

Conversion from value to the Byte type is not supported.

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.

No code example is currently available or this language may not be supported.

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.

No code example is currently available or this language may not be supported.

Universal Windows Platform
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
Return to top
Show:
© 2017 Microsoft