Convert.ToString Method (Double, IFormatProvider)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Converts the value of the specified double-precision floating point number to its equivalent String representation.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type: System.Double
A double-precision floating point number.
- provider
- Type: System.IFormatProvider
An IFormatProvider interface implementation that supplies culture-specific formatting information.
Return Value
Type: System.StringThe String equivalent of the value of value.
provider is ignored; it does not participate in this operation.
This implementation is identical to Double.ToString.
The following code example converts a Double value to a String with the ToString method, using an IFormatProvider object.
// Example of the Convert.ToString( numeric types ) and // Convert.ToString( numeric types, IFormatProvider ) methods. using System; using System.Globalization; class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { // Create a NumberFormatInfo object and set several of its // properties that apply to numbers. NumberFormatInfo provider = new NumberFormatInfo(); string formatter = "{0,22} {1}"; // These properties will affect the conversion. provider.NegativeSign = "minus "; provider.NumberDecimalSeparator = " point "; // These properties will not be applied. provider.NumberDecimalDigits = 2; provider.NumberGroupSeparator = "."; provider.NumberGroupSizes = new int[] { 3 }; // Convert these values using default values and the // format provider created above. byte ByteA = 140; SByte SByteA = -60; UInt16 UInt16A = 61680; short Int16A = -3855; UInt32 UInt32A = 4042322160; int Int32A = -252645135; UInt64 UInt64A = 8138269444283625712; long Int64A = -1085102592571150095; float SingleA = -32.375F; double DoubleA = 61680.3855; decimal DecimA = 4042322160.252645135M; object ObjDouble = (object)(-98765.4321); outputBlock.Text += "This example of " + "Convert.ToString( numeric types ) and \n" + "Convert.ToString( numeric types, IFormatProvider ) \n" + "converts values of each of the CLR base numeric types " + "to strings, \nusing default formatting and a " + "NumberFormatInfo object." + "\n"; outputBlock.Text += "\nNote: Of the several NumberFormatInfo " + "properties that are changed, \nonly the negative sign " + "and decimal separator affect the conversions.\n" + "\n"; outputBlock.Text += String.Format(formatter, "Default", "Format Provider") + "\n"; outputBlock.Text += String.Format(formatter, "-------", "---------------") + "\n"; // Convert the values with and without a format provider. outputBlock.Text += String.Format(formatter, Convert.ToString(ByteA), Convert.ToString(ByteA, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(SByteA), Convert.ToString(SByteA, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(UInt16A), Convert.ToString(UInt16A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(Int16A), Convert.ToString(Int16A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(UInt32A), Convert.ToString(UInt32A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(Int32A), Convert.ToString(Int32A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(UInt64A), Convert.ToString(UInt64A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(Int64A), Convert.ToString(Int64A, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(SingleA), Convert.ToString(SingleA, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(DoubleA), Convert.ToString(DoubleA, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(DecimA), Convert.ToString(DecimA, provider)) + "\n"; outputBlock.Text += String.Format(formatter, Convert.ToString(ObjDouble), Convert.ToString(ObjDouble, provider)) + "\n"; } } /* This example of Convert.ToString( numeric types ) and Convert.ToString( numeric types, IFormatProvider ) converts values of each of the CLR base numeric types to strings, using default formatting and a NumberFormatInfo object. Note: Of the several NumberFormatInfo properties that are changed, only the negative sign and decimal separator affect the conversions. Default Format Provider ------- --------------- 140 140 -60 minus 60 61680 61680 -3855 minus 3855 4042322160 4042322160 -252645135 minus 252645135 8138269444283625712 8138269444283625712 -1085102592571150095 minus 1085102592571150095 -32.375 minus 32 point 375 61680.3855 61680 point 3855 4042322160.252645135 4042322160 point 252645135 -98765.4321 minus 98765 point 4321 */
Show: