ToString Method (Byte, Int32)

# Convert.ToString Method (Byte, Int32)

.NET Framework (current version)

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)

## Syntax

```Public Shared Function ToString (
value As Byte,
toBase As Integer
) As String
```

#### Parameters

value
Type: System.Byte

The 8-bit unsigned integer to convert.

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

## Exceptions

Exception Condition
ArgumentException

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

## Remarks

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

## Examples

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

```Dim bases() As Integer = { 2, 8, 10, 16}
Dim numbers() As Byte = { Byte.MinValue, 12, 103, Byte.MaxValue}

For Each base As Integer In bases
Console.WriteLine("Base {0} conversion:", base)
For Each number As Byte In numbers
Console.WriteLine("   {0,-5}  -->  0x{1}", _
number, Convert.ToString(number, base))
Next
Next
' The example displays the following output:
'       Base 2 conversion:
'          0      -->  0x0
'          12     -->  0x1100
'          103    -->  0x1100111
'          255    -->  0x11111111
'       Base 8 conversion:
'          0      -->  0x0
'          12     -->  0x14
'          103    -->  0x147
'          255    -->  0x377
'       Base 10 conversion:
'          0      -->  0x0
'          12     -->  0x12
'          103    -->  0x103
'          255    -->  0x255
'       Base 16 conversion:
'          0      -->  0x0
'          12     -->  0xc
'          103    -->  0x67
'          255    -->  0xff
```

## Version Information

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