Convert.ToString Method (Byte, Int32)
Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.
Assembly: mscorlib (in mscorlib.dll)
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.
| Exception | Condition |
|---|---|
| ArgumentException | 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.
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
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