Byte::ToString Method (IFormatProvider)

Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

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

public:
virtual String^ ToString(
	IFormatProvider^ provider
) sealed

Parameters

provider
Type: System::IFormatProvider

An object that supplies culture-specific formatting information.

Return Value

Type: System::String
The string representation of the value of this object in the format specified by the provider parameter.

Implements

IConvertible::ToString(IFormatProvider)

The return value is formatted with the general numeric format specifier ("G").

The provider parameter is an object that implements the IFormatProvider interface. Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. The object that implements IFormatProvider can be any of the following:

  • A CultureInfo object that represents the culture whose formatting rules are to be used.

  • A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • A custom object that implements IFormatProvider.

If provider is nullptr or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. For information about the thread current culture, see Thread::CurrentCulture.

The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

The following example iterates an array of byte values and displays each of them to the console by calling the ToString(IFormatProvider) method with different format providers.

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
array<CultureInfo^>^ providers = {gcnew CultureInfo("en-us"), 
                                  gcnew CultureInfo("fr-fr"), 
                                  gcnew CultureInfo("de-de"), 
                                  gcnew CultureInfo("es-es")};
for each (Byte byteValue in bytes)
{
   for each (CultureInfo^ provider in providers)
      Console::Write("{0,3} ({1})      ", 
                    byteValue.ToString(provider), provider->Name);

   Console::WriteLine();                                        
}
// The example displays the following output to the console: 
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES) 
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES) 
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES) 
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES) 
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)            

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft