Export (0) Print
Expand All

Double.ToString Method ()

Converts the numeric value of this instance to its equivalent string representation.

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

public override string ToString ()
public String ToString ()
public override function ToString () : String

Return Value

The string representation of the value of this instance.

The return value can be PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, or a string of the form:

[sign]integral-digits[.[fractional-digits]][e[sign]exponential-digits]

Optional items are framed in square brackets ([ and ]). Items containing the term "digits" consist of a series of numeric characters ranging from 0 to 9.

sign

A negative sign or positive sign symbol.

integral-digits

A series of digits specifying the integral part of the number. Integral-digits can be absent if there are fractional-digits.

'.'

A culture-specific decimal point symbol.

fractional-digits

A series of digits specifying the fractional part of the number.

'e'

A lowercase character 'e', indicating exponential (scientific) notation.

exponential-digits

A series of digits specifying an exponent.

Some examples of the return value are "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123", and "-Infinity".

This version of the ToString method implicitly uses the general format specifier ("G") and the NumberFormatInfo for the current culture.

The following code example illustrates the use of ToString:

bool done = false;
string inp;
do 
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try 
    {
        d = Double.Parse(inp);
        Console.WriteLine("You entered {0}.", d.ToString());
        done = true;
    } 
    catch (FormatException) 
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e) 
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);

boolean done = false;
String inp;

do {
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try {
        d = new Double(inp);
        Console.WriteLine("You entered {0}.", d.ToString());
        done = true;
    }
    catch (FormatException exp) {
        Console.WriteLine("You did not enter a number.");
    }
    catch (System.Exception e) {
        Console.WriteLine(
            "An exception occurred while parsing your response: {0}",
            e.ToString());
    }
} while (!(done));

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft