Convert.ToString Method (Int64, Int32)

Converts the value of a 64-bit signed 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 Long, _
    toBase As Integer _
) As String
[SecuritySafeCriticalAttribute]
public static string ToString(
    long 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.

Remarks

If value is negative and toBase is a non-decimal value, the returned string uses two's complement representation.

Examples

The following code example converts several 64-bit integers to String s with the ToString method in the radixes supported by the method.

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

Module Example

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

      Dim values As Long() = { _
          Long.MinValue, _
          -112233445566778899, _
          4294967296, _
          999999999999999999, _
          Long.MaxValue}
      Dim radices As Integer() = {2, 8, 10, 16}

      ' Iterate through the values array.
      Dim value As Long
      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)

            ' Display the results; use two lines, if necessary.
            If valueString.Length > 50 Then
               outputBlock.Text &= String.Format("{0,20} {1,3} " & _
                   vbCrLf & "          {2}", _
                   value, radix, valueString) & vbCrLf
            Else
               outputBlock.Text &= String.Format("{0,20} {1,3}   {2}", _
                   value, radix, valueString) & vbCrLf
            End If
         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( Long, Integer ) " & _
          "generates " & vbCrLf & "the following output. It " & _
          "converts several Long 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( Long, Integer ) generates
' the following output. It converts several Long values to
' strings using the radixes supported by the method.
' 
'           Value      Radix     String
'           -----      -----     ------
' -9223372036854775808   2
'           1000000000000000000000000000000000000000000000000000000000000000
' -9223372036854775808   8   1000000000000000000000
' -9223372036854775808  10   -9223372036854775808
' -9223372036854775808  16   8000000000000000
'  -112233445566778899   2
'           1111111001110001010001000100011010100001000100101111000111101101
'  -112233445566778899   8   1771612104324104570755
'  -112233445566778899  10   -112233445566778899
'  -112233445566778899  16   fe714446a112f1ed
'           4294967296   2   100000000000000000000000000000000
'           4294967296   8   40000000000
'           4294967296  10   4294967296
'           4294967296  16   100000000
'   999999999999999999   2
'           110111100000101101101011001110100111011000111111111111111111
'   999999999999999999   8   67405553164730777777
'   999999999999999999  10   999999999999999999
'   999999999999999999  16   de0b6b3a763ffff
'  9223372036854775807   2
'           111111111111111111111111111111111111111111111111111111111111111
'  9223372036854775807   8   777777777777777777777
'  9223372036854775807  10   9223372036854775807
'  9223372036854775807  16   7fffffffffffffff
// Example of the Convert.ToString( long, int ) method.
using System;

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

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

            // Display the results; use two lines, if necessary.
            if (valueString.Length > 50)
               outputBlock.Text += String.Format(
                   "{0,20} {1,3} \n          {2}",
                   value, radix, valueString) + "\n";
            else
               outputBlock.Text += String.Format("{0,20} {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( long, int ) " +
          "generates \nthe following output. It converts several " +
          "long 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( long, int ) generates
the following output. It converts several long values to
strings using the radixes supported by the method.

          Value      Radix     String
          -----      -----     ------
-9223372036854775808   2
          1000000000000000000000000000000000000000000000000000000000000000
-9223372036854775808   8   1000000000000000000000
-9223372036854775808  10   -9223372036854775808
-9223372036854775808  16   8000000000000000
 -112233445566778899   2
          1111111001110001010001000100011010100001000100101111000111101101
 -112233445566778899   8   1771612104324104570755
 -112233445566778899  10   -112233445566778899
 -112233445566778899  16   fe714446a112f1ed
          4294967296   2   100000000000000000000000000000000
          4294967296   8   40000000000
          4294967296  10   4294967296
          4294967296  16   100000000
  999999999999999999   2
          110111100000101101101011001110100111011000111111111111111111
  999999999999999999   8   67405553164730777777
  999999999999999999  10   999999999999999999
  999999999999999999  16   de0b6b3a763ffff
 9223372036854775807   2
          111111111111111111111111111111111111111111111111111111111111111
 9223372036854775807   8   777777777777777777777
 9223372036854775807  10   9223372036854775807
 9223372036854775807  16   7fffffffffffffff
*/

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.