UInt64.ToString Method (String)
Converts the numeric value of this instance to its equivalent string representation using the specified format.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- format
-
Type:
System.String
A numeric format string.
Return Value
Type: System.StringThe string representation of the value of this instance as specified by format.
| Exception | Condition |
|---|---|
| FormatException | The format parameter is invalid. |
The ToString(String) method formats a UInt64 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:
To use format | For culture | Use the overload |
|---|---|---|
Default ("G") format | Default (current) culture | |
Default ("G") format | A specific culture | |
A specific format | A specific culture |
The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. If format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). If format is any other value, the method throws a FormatException.
The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:
For more information about numeric format specifiers, see Standard Numeric Format Strings and Custom Numeric Format Strings.
For more information about support for formatting in the .NET Framework, see Formatting Types in the .NET Framework.
The format of the returned string is determined by the NumberFormatInfo object for the current culture. Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.
The following example displays a 64-bit unsigned integer value by using each standard format string and some custom format strings.
using System; using System.Globalization; public class Example { public static void Main() { ulong value = 217960834; string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", "N", "P", "X", "000000.0", "#.0", "00000000;(0);**Zero**" }; foreach (string specifier in specifiers) Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier)); } } // The example displays the following output: // G: 217960834 // C: $217,960,834.00 // D3: 217960834 // E2: 2.18E+008 // e3: 2.180e+008 // F: 217960834.00 // N: 217,960,834.00 // P: 21,796,083,400.00 % // X: CFDD182 // 000000.0: 217960834.0 // #.0: 217960834.0 // 00000000;(0);**Zero**: 217960834
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1