Convert.ToString Method (Decimal)

[ 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 Decimal number to its equivalent String representation.

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

Syntax

Public Shared Function ToString ( _
    value As Decimal _
) As String

public static string ToString(
    decimal value
)

Parameters

• value
  Type: System..::.Decimal
  A Decimal number.

Return Value

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

Remarks

This implementation is identical to Decimal..::.ToString.

Examples

The following code sample illustrates the conversion of a Decimal to a String, using ToString.

Public Sub ConvertStringDecimal(ByVal stringVal As String)
   Dim decimalVal As Decimal = 0

   Try
      decimalVal = System.Convert.ToDecimal(stringVal)
      outputBlock.Text &= String.Format("The string as a decimal is {0}.", _
                                decimalVal) & vbCrLf
   Catch exception As System.OverflowException
      outputBlock.Text &= String.Format( _
          "Overflow in string-to-decimal conversion.") & vbCrLf
   Catch exception As System.FormatException
      outputBlock.Text &= String.Format( _
          "The string is not formatted as a decimal.") & vbCrLf
   Catch exception As System.ArgumentException
      outputBlock.Text &= "The string is null." & vbCrLf
   End Try

   ' Decimal to string conversion will not overflow.
   stringVal = System.Convert.ToString(decimalVal)
   outputBlock.Text &= String.Format("The decimal as a string is {0}.", _
                             stringVal) & vbCrLf
End Sub

public void ConvertStringDecimal(string stringVal)
{
   decimal decimalVal = 0;

   try
   {
      decimalVal = System.Convert.ToDecimal(stringVal);
      outputBlock.Text += String.Format(
         "The string as a decimal is {0}.", decimalVal) + "\n";
   }
   catch (System.OverflowException)
   {
      outputBlock.Text += String.Format(
         "The conversion from string to decimal overflowed.") + "\n";
   }
   catch (System.FormatException)
   {
      outputBlock.Text += String.Format(
         "The string is not formatted as a decimal.") + "\n";
   }
   catch (System.ArgumentNullException)
   {
      outputBlock.Text += String.Format(
         "The string is null.") + "\n";
   }

   // Decimal to string conversion will not overflow.
   stringVal = System.Convert.ToString(decimalVal);
   outputBlock.Text += String.Format(
      "The decimal as a string is {0}.", stringVal) + "\n";
}

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

Convert Class

ToString Overload

System Namespace