UInt16.ToString Method (IFormatProvider)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- provider
- Type: System.IFormatProvider
An object that supplies culture-specific formatting information.
Return Value
Type: System.StringThe string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.
Implements
IConvertible.ToString(IFormatProvider)This instance is formatted with the general numeric format specifier ("G"). The string representation of the UInt16 value consists of a sequence of digits ranging from 0 to 9 without leading zeros.
The provider parameter is an IFormatProvider implementation. Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").
The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.
using System; using System.Globalization; public class Example { public static void Demo(System.Windows.Controls.TextBlock outputBlock) { // Define an array of CultureInfo objects. CultureInfo[] ci = { new CultureInfo("en-US"), new CultureInfo("fr-FR"), CultureInfo.InvariantCulture }; UInt16 value = 18924; outputBlock.Text += String.Format(" {0,12} {1,12} {2,12}", GetName(ci[0]), GetName(ci[1]), GetName(ci[2])) + "\n"; outputBlock.Text += String.Format(" {0,12} {1,12} {2,12}", value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2])) + "\n"; } private static string GetName(CultureInfo ci) { if (ci.Equals(CultureInfo.InvariantCulture)) return "Invariant"; else return ci.Name; } } // The example displays the following output: // en-US fr-FR Invariant // 18924 18924 18924