.NET Framework Class Library
Int32ToString Method

Converts the numeric value of this instance to its equivalent string representation.

Namespace:   System
Assemblies:   mscorlib (in mscorlib.dll)
  System.Runtime (in System.Runtime.dll)
Syntax
Public Overrides Function ToString As [%$TOPIC/6t7dwaa5_en-us_VS_110_1_0_0_0_0%]
public override [%$TOPIC/6t7dwaa5_en-us_VS_110_1_0_1_0_0%] ToString()
public:
virtual [%$TOPIC/6t7dwaa5_en-us_VS_110_1_0_2_0_0%]^ ToString() override
abstract ToString : unit -> [%$TOPIC/6t7dwaa5_en-us_VS_110_1_0_3_0_0%]  
override ToString : unit -> [%$TOPIC/6t7dwaa5_en-us_VS_110_1_0_3_0_1%]

Return Value

Type: SystemString
The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.
Remarks

The ToString method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

To use format

For culture

Use the overload

Default ("G") format

A specific culture

ToString(IFormatProvider)

A specific format

Default (current) culture

ToString(String)

A specific format

A specific culture

ToString(String, IFormatProvider)

The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Examples

The following example displays an Int32 value using the default ToString method. It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. The examples are displayed using the formatting conventions of the en-US culture.

Dim value As Integer = -16325
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325
Console.WriteLine(value.ToString("F"))         ' Displays -16325.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFC03B      
int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325 
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B      
Version Information

.NET Framework

Supported in: 4.6, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Platforms

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.