Int32::ToString Method (IFormatProvider^)


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

Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

virtual String^ ToString(
	IFormatProvider^ provider
) sealed


Type: System::IFormatProvider^

An object that supplies culture-specific formatting information.

Return Value

Type: System::String^

The string representation of the value of this instance as specified by provider.

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

To use format

For culture

Use the overload

Default ("G") format

Default (current) culture


A specific format

Default (current) culture


A specific format

A specific culture

ToString(String^, IFormatProvider^)

The provider parameter is an object that implements the IFormatProvider interface. Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. The object that implements IFormatProvider can be any of the following:

If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. For information about the thread current culture, see Thread::CurrentCulture.

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

The following example displays the string representation of an Int32 value using CultureInfo objects that represent several different cultures.

using namespace System;
using namespace System::Globalization;

void main()
    int value = -16325;
    // Display value using the invariant culture.
    // Display value using the en-GB culture.
    // Display value using the de-DE culture.
// The example displays the following output:
//       -16325
//       -16325
//       -16325

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