Convert::ToString Method (Byte, Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.

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

static String^ ToString(
	unsigned char value,
	int toBase


Type: System::Byte

The 8-bit unsigned integer to convert.

Type: System::Int32

The base of the return value, which must be 2, 8, 10, or 16.

Return Value

Type: System::String^

The string representation of value in base toBase.

Exception Condition

toBase is not 2, 8, 10, or 16.

If toBase does not equal 10, the string that is returned by the Convert::ToString(Byte, Int32) method represents value by its magnitude only. If the method is called to create a string that will later be converted back to a number, a corresponding method that assumes a magnitude-only numeric representation should be called to perform the conversion. Such methods include Convert::ToByte(String^, Int32) or Byte::Parse(String^, NumberStyles).

The following example converts each element in a byte array to its equivalent binary, hexadecimal, decimal, and hexadecimal string representations.

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
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top