Convert.ToString Method (Byte, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Function ToString ( _
    value As Byte, _
    toBase As Integer _
) As String
[SecuritySafeCriticalAttribute]
public static string ToString(
    byte value,
    int toBase
)

Parameters

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

Examples

The following code example converts several Byte values to String s with the ToString method in the radixes supported by the method.

' Example of the Convert.ToString( Byte, Integer ) method.

Module Example

   Sub RunToStringDemo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      Dim values As Byte() = { _
          Byte.MinValue, _
          13, _
          Byte.MaxValue}
      Dim radices As Integer() = {2, 8, 10, 16}

      ' Iterate through the values array.
      Dim value As Byte
      For Each value In values

         ' Iterate through the radices.
         Dim radix As Integer
         For Each radix In radices

            ' Convert a value with a radix.
            Dim valueString As String = _
                Convert.ToString(value, radix)

            outputBlock.Text &= String.Format("{0,7}  {1,3}    {2}", _
                value, radix, valueString) & vbCrLf
         Next radix
      Next value
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      outputBlock.Text &= String.Format( _
          "This example of Convert.ToString( Byte, Integer ) " & _
          "generates " & vbCrLf & "the following output. It " & _
          "converts several Byte values to " & vbCrLf & "strings " & _
          "using the radixes supported by the method.") & vbCrLf
      outputBlock.Text &= String.Format(vbCrLf & _
          "  Value  Radix  String" & vbCrLf & _
          "  -----  -----  ------") & vbCrLf

      RunToStringDemo(outputBlock)

   End Sub
End Module

' This example of Convert.ToString( Byte, Integer ) generates
' the following output. It converts several Byte values to
' strings using the radixes supported by the method.
' 
'   Value  Radix  String
'   -----  -----  ------
'       0    2    0
'       0    8    0
'       0   10    0
'       0   16    0
'      13    2    1101
'      13    8    15
'      13   10    13
'      13   16    d
'     255    2    11111111
'     255    8    377
'     255   10    255
'     255   16    ff
// Example of the Convert.ToString( byte, int ) method.
using System;

class Example
{
   static void RunToStringDemo(System.Windows.Controls.TextBlock outputBlock)
   {
      byte[] values = {
            byte.MinValue, 
            13, 
            byte.MaxValue };
      int[] radices = { 2, 8, 10, 16 };

      // Iterate through the values array.
      foreach (byte value in values)
      {
         // Iterate through the radices.
         foreach (int radix in radices)
         {
            // Convert a value with a radix.
            string valueString =
                Convert.ToString(value, radix);

            outputBlock.Text += String.Format("{0,7}  {1,3}    {2}",
                value, radix, valueString) + "\n";
         }
      }
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text += String.Format(
          "This example of Convert.ToString( byte, int ) " +
          "generates \nthe following output. It converts several " +
          "byte values to \nstrings using the radixes supported " +
          "by the method.") + "\n";
      outputBlock.Text += String.Format(
          "\n  Value  Radix  String" +
          "\n  -----  -----  ------") + "\n";

      RunToStringDemo(outputBlock);
   }
}

/*
This example of Convert.ToString( byte, int ) generates
the following output. It converts several byte values to
strings using the radixes supported by the method.

  Value  Radix  String
  -----  -----  ------
      0    2    0
      0    8    0
      0   10    0
      0   16    0
     13    2    1101
     13    8    15
     13   10    13
     13   16    d
    255    2    11111111
    255    8    377
    255   10    255
    255   16    ff
*/

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.