ToString Method (Int64, IFormatProvider)

Convert.ToString Method (Int64, IFormatProvider)


Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.

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

public static string ToString(
	long value,
	IFormatProvider provider


Type: System.Int64

The 64-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 Int64.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(Int64, IFormatProvider) method to convert each element in a long integer array to its equivalent string representation. The conversion uses the invariant culture as well as the custom NumberFormatInfo object.

long[] numbers = { ((long) Int32.MinValue) * 2, ((long) Int32.MaxValue) * 2};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (long number 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:
//       -4294967296  -->  ~4294967296
//       4294967294  -->  4294967294

Universal Windows Platform
Available since 4.5
.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
© 2015 Microsoft