ToString Method (UInt16, IFormatProvider)

Convert.ToString Method (UInt16, IFormatProvider)

 

Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.

This API is not CLS-compliant.

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

[CLSCompliantAttribute(false)]
public static string ToString(
	ushort value,
	IFormatProvider provider
)

Parameters

value
Type: System.UInt16

The 16-bit unsigned integer to convert.

provider
Type: System.IFormatProvider

An object that supplies culture-specific formatting information.

Return Value

Type: System.String

The string representation of value.

This implementation is identical to UInt16.ToString(IFormatProvider).

The following example defines a custom NumberFormatInfo class that defines its negative sign as the string "~" and its positive sign as the string "!". It then calls the ToString(UInt16, IFormatProvider) method to convert a 16-bit unsigned integer value to its equivalent string representation. The conversion uses both the invariant culture and the custom NumberFormatInfo object. The output indicates that this formatting information is not used, because by default the "G" format specifier does not include a positive sign with positive values.

ushort number = UInt16.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-6}  -->  {1,6}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//       65535   -->   65535

Universal Windows Platform
Available since 4.5
.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
Return to top
Show:
© 2016 Microsoft