Convert.ToString Method (Single, IFormatProvider)

Converts the value of the specified single-precision floating point number to its equivalent String representation.

Parameters

• value
  Type: System.Single
  A single-precision floating point number.

• provider
  Type: System.IFormatProvider
  An IFormatProvider interface implementation that supplies culture-specific formatting information.

Return Value

Type: System.String
The String equivalent of the value of value.

' Example of the Convert.ToString( numeric types ) and 
' Convert.ToString( numeric types, IFormatProvider ) methods.
Imports System.Globalization
Module Example
 Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
 ' Create a NumberFormatInfo object and set several of its
 ' properties that apply to numbers.
 Dim provider As NumberFormatInfo = New NumberFormatInfo()
 Dim formatter As String = "{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 Integer() {3}
 ' Convert these values using default values and the
 ' format provider created above.
 Dim ByteA As Byte = 140
 Dim SByteA As SByte = Convert.ToSByte(-60)
 Dim UInt16A As UInt16 = Convert.ToUInt16(61680)
 Dim Int16A As Short = -3855
 Dim UInt32A As UInt32 = Convert.ToUInt32(4042322160)
 Dim Int32A As Integer = -252645135
 Dim UInt64A As UInt64 = _
 Convert.ToUInt64(8138269444283625712)
 Dim Int64A As Long = -1085102592571150095
 Dim SingleA As Single = -32.375F
 Dim DoubleA As Double = 61680.3855
 Dim DecimA As Decimal = 4042322160.252645135D
 Dim ObjDouble As Object = CType(-98765.4321, Object)
 outputBlock.Text &= "This example of " & _
 "Convert.ToString( numeric types ) and " & vbCrLf & _
 "Convert.ToString( numeric types, IFormatProvider ) " & _
 vbCrLf & "converts values of each of the CLR base " & _
 "numeric types to strings, " & vbCrLf & "using " & _
 "default formatting and a NumberFormatInfo object." & vbCrLf
 outputBlock.Text &= vbCrLf & _
 "Note: Of the several NumberFormatInfo properties " & _
 "that are changed, " & vbCrLf & "only the negative " & _
 "sign and decimal separator affect the conversions." & vbCrLf
 outputBlock.Text &= String.Format(vbCrLf & formatter, _
 "Default", "Format Provider") & vbCrLf
 outputBlock.Text &= String.Format(formatter, _
 "-------", "---------------") & vbCrLf
 ' Convert the values with and without a format provider.
 outputBlock.Text &= String.Format(formatter, Convert.ToString(ByteA) & vbCrLf, _
 Convert.ToString(ByteA, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(SByteA) & vbCrLf, _
 Convert.ToString(SByteA, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(UInt16A) & vbCrLf, _
 Convert.ToString(UInt16A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(Int16A) & vbCrLf, _
 Convert.ToString(Int16A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(UInt32A) & vbCrLf, _
 Convert.ToString(UInt32A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(Int32A) & vbCrLf, _
 Convert.ToString(Int32A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(UInt64A) & vbCrLf, _
 Convert.ToString(UInt64A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(Int64A) & vbCrLf, _
 Convert.ToString(Int64A, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(SingleA) & vbCrLf, _
 Convert.ToString(SingleA, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(DoubleA) & vbCrLf, _
 Convert.ToString(DoubleA, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(DecimA) & vbCrLf, _
 Convert.ToString(DecimA, provider))
 outputBlock.Text &= String.Format(formatter, Convert.ToString(ObjDouble) & vbCrLf, _
 Convert.ToString(ObjDouble, provider))
 End Sub
End Module
' 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

// 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
*/

Convert Class

ToString Overload

System Namespace