Export (0) Print
Expand All

Convert.ToString Method (Int32, Int32)

Converts the value of a 32-bit signed integer to its equivalent String representation in a specified base.

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

'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Function ToString ( _
	value As Integer, _
	toBase As Integer _
) As String

Parameters

value
Type: System.Int32
A 32-bit signed integer.
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.

ExceptionCondition
ArgumentException

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

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

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


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

Module Example

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

      Dim values As Integer() = { _
          Integer.MinValue, _
          -100, _
          0, _
          99999, _
          Integer.MaxValue}
      Dim radices As Integer() = {2, 8, 10, 16}

      ' Iterate through the values array.
      Dim value As Integer
      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,13}  {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( Integer, Integer " & _
          ") generates " & vbCrLf & "the following output. It " & _
          "converts several Integer 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( Integer, Integer ) generates
' the following output. It converts several Integer values to
' strings using the radixes supported by the method.
' 
'      Value     Radix    String
'      -----     -----    ------
'   -2147483648    2    10000000000000000000000000000000
'   -2147483648    8    20000000000
'   -2147483648   10    -2147483648
'   -2147483648   16    80000000
'          -100    2    11111111111111111111111110011100
'          -100    8    37777777634
'          -100   10    -100
'          -100   16    ffffff9c
'             0    2    0
'             0    8    0
'             0   10    0
'             0   16    0
'         99999    2    11000011010011111
'         99999    8    303237
'         99999   10    99999
'         99999   16    1869f
'    2147483647    2    1111111111111111111111111111111
'    2147483647    8    17777777777
'    2147483647   10    2147483647
'    2147483647   16    7fffffff


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

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

Community Additions

ADD
Show:
© 2014 Microsoft