Convert.ToString Method (Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Converts the value of the specified 32-bit signed integer to its equivalent string representation.

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

Public Shared Function ToString (
	value As Integer
) As String


Type: System.Int32

The 32-bit signed integer to convert.

Return Value

Type: System.String

The string representation of value.

This implementation is identical to Int32.ToString(). It formats value by using the formatting conventions of the current thread culture.

The following example compares the ToString(Int32) method with the ToString(UInt16, IFormatProvider) method. It defines a custom NumberFormatInfo object that uses the sting "minus" to represent the negative sign. It converts each element in an integer array to its equivalent string representation using default formatting (the formatting conventions of the current culture) and the custom format provider.

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Create a NumberFormatInfo object and set its NegativeSigns
      ' property to use for integer formatting.
      Dim provider As New NumberFormatInfo()
      provider.NegativeSign = "minus "

      Dim values() As Integer = { -20, 0, 100 }

      Console.WriteLine("{0,-8} --> {1,10} {2,10}", "Value",
      For Each value As Integer In values
         Console.WriteLine("{0,-8} --> {1,10} {2,10}",
                           value, Convert.ToString(value),
                           Convert.ToString(value, provider))
   End Sub
End Module
' The example displays output like the following:
'       Value    -->      en-US     Custom
'       -20      -->        -20   minus 20
'       0        -->          0          0
'       100      -->        100        100

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top