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 static string ToString(
	int value


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.

using System;
using System.Globalization;

public class Example
   public static void Main()
      // Create a NumberFormatInfo object and set its NegativeSigns
      // property to use for integer formatting.
      NumberFormatInfo provider = new NumberFormatInfo();
      provider.NegativeSign = "minus ";

      int[] values = { -20, 0, 100 };

      Console.WriteLine("{0,-8} --> {1,10} {2,10}\n", "Value",
      foreach (int value in values)
         Console.WriteLine("{0,-8} --> {1,10} {2,10}",
                           value, Convert.ToString(value),
                           Convert.ToString(value, provider));
      // 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