Convert.ToString Method (Int32, IFormatProvider)


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, using the specified culture-specific formatting information.

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

Public Shared Function ToString (
	value As Integer,
	provider As IFormatProvider
) As String


Type: System.Int32

The 32-bit signed integer to convert.

Type: System.IFormatProvider

An object that supplies culture-specific formatting information.

Return Value

Type: System.String

The string representation of value.

This implementation is identical to Int32.ToString(IFormatProvider).

The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". It then calls the ToString(Int32, IFormatProvider) method to convert each element in an array of integers to its equivalent string representation. The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

Dim numbers() As Integer = { Int32.MinValue, Int32.MaxValue}
Dim nfi As New System.Globalization.NumberFormatInfo()
nfi.NegativeSign = "~"
nfi.PositiveSign = "!"

For Each number As Integer In numbers
   Console.WriteLine("{0,-12}  -->  {1,12}", _
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture), _
                     Convert.ToString(number, nfi))
' The example displays the following output:
'       -2147483648  -->  ~2147483648
'       2147483647   -->  2147483647

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