Byte.ToString Byte.ToString Byte.ToString Byte.ToString Method

Definition

Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation.

Überlädt

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert des aktuellen Byte-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats sowie der kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert des aktuellen Byte-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieses Objekts in dem vom provider-Parameter angegebenen Format.The string representation of the value of this object in the format specified by the provider parameter.

Implementiert

Beispiele

Im folgenden Beispiel wird ein Array von Bytewerten Werte und jedes Mitglied in der Konsole angezeigt, durch den Aufruf der ToString(IFormatProvider) -Methode mit verschiedenen Formatanbieter.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)            
byte[] bytes = {0, 1, 14, 168, 255};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
foreach (byte byteValue in bytes)
{
   foreach (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)            
Dim bytes() As Byte = {0, 1, 14, 168, 255}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each byteValue As Byte In bytes
   For Each provider As CultureInfo In providers
      Console.Write("{0,3} ({1})      ", byteValue.ToString(provider), provider.Name)
   Next
   Console.WriteLine()                                        
Next
' 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)            

Hinweise

Der zurückgegebene Wert wird mit dem allgemeinen numerische Formatbezeichner ("G") formatiert.The return value is formatted with the general numeric format specifier ("G").

Die provider -Parameter ist ein Objekt, implementiert die IFormatProvider Schnittstelle.The provider parameter is an object that implements the IFormatProvider interface. Die GetFormat Methode gibt eine NumberFormatInfo -Objekt, das kulturspezifische Informationen zum Format der Zeichenfolge enthält, die von dieser Methode zurückgegeben wird.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Das Objekt, das implementiert IFormatProvider kann eine der folgenden sein:The object that implements IFormatProvider can be any of the following:

  • Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Ein NumberFormatInfo Objekt, das numerische Formatierungsinformationen für diesen Wert enthält.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Ein benutzerdefiniertes Objekt, das implementiert IFormatProvider.A custom object that implements IFormatProvider.

Wenn provider ist null oder NumberFormatInfo Objekt kann nicht abgerufen werden, von provider, der Rückgabewert formatiert wird, mit der NumberFormatInfo -Objekt für die aktuelle Threadkultur.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Informationen über die aktuelle Threadkultur, finden Sie unter Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Siehe auch

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats sowie der kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String String String String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des aktuellen Byte-Objekts im durch die format- und provider-Parameter angegebenen Format.The string representation of the current Byte object, formatted as specified by the format and provider parameters.

Implementiert

Ausnahmen

format enthält einen nicht unterstützten Spezifizierer.format includes an unsupported specifier. Unterstützte Formatspezifizierer sind im Abschnitt "Hinweise" aufgeführt.Supported format specifiers are listed in the Remarks section.

Beispiele

Im folgenden Beispiel wird die Formatzeichenfolge der standard ist "N" und vier verschiedene CultureInfo Objekte an die angegebene Zeichenfolgendarstellung ein Byte-Wert in der Konsole anzeigen.The following example uses the standard "N" format string and four different CultureInfo objects to display the string representation of a byte value to the console.

Byte byteValue = 250;
array<CultureInfo^>^ providers = gcnew array<CultureInfo^> { gcnew CultureInfo("en-us"), 
                                                             gcnew CultureInfo("fr-fr"), 
                                                             gcnew CultureInfo("es-es"), 
                                                             gcnew CultureInfo("de-de")}; 

for each (CultureInfo^ provider in providers) 
   Console::WriteLine("{0} ({1})", 
                     byteValue.ToString("N2", provider), provider->Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)  
byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("es-es"), 
                           new CultureInfo("de-de")}; 

foreach (CultureInfo provider in providers) 
   Console.WriteLine("{0} ({1})", 
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)      
Dim byteValue As Byte = 250
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("es-es"), _
                                  New CultureInfo("de-de")} 
For Each provider As CultureInfo In providers 
   Console.WriteLine("{0} ({1})", _
                     byteValue.ToString("N2", provider), provider.Name)
Next   
' The example displays the following output to the console:
'       250.00 (en-US)
'       250,00 (fr-FR)
'       250,00 (es-ES)
'       250,00 (de-DE)      

Hinweise

Die ToString(String, IFormatProvider) -Methode formatiert einen Byte Wert in einem angegebenen Format einer angegebenen Kultur.The ToString(String, IFormatProvider) method formats a Byte value in a specified format of a specified culture. Um eine Zahl mit dem Standardwert ("G")-Format für die aktuelle Kultur zu formatieren, rufen Sie die ToString() Methode.To format a number by using the default ("G") format of the current culture, call the ToString() method. Um eine Zahl mit einem angegebenen Format für die aktuelle Kultur zu formatieren, rufen Sie die ToString(String) Methode.To format a number by using a specified format of the current culture, call the ToString(String) method.

Die format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Formatzeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle numerischen Standardformatzeichenfolgen als "R" (oder "R") werden unterstützt, da alle benutzerdefinierten numerischen Formatierungszeichen sind.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format ist null oder eine leere Zeichenfolge (""), der Rückgabewert dieser Methode mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist.If format is null or an empty string (""), the return value of this method is formatted with the general numeric format specifier ("G").

Die provider -Parameter ist ein Objekt, implementiert die IFormatProvider Schnittstelle.The provider parameter is an object that implements the IFormatProvider interface. Die GetFormat Methode gibt eine NumberFormatInfo -Objekt, das kulturspezifische Informationen zum Format der Zeichenfolge enthält, die von dieser Methode zurückgegeben wird.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Das Objekt, das implementiert IFormatProvider kann eine der folgenden sein:The object that implements IFormatProvider can be any of the following:

  • Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Ein NumberFormatInfo Objekt, das numerische Formatierungsinformationen für diesen Wert enthält.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Ein benutzerdefiniertes Objekt, das implementiert IFormatProvider.A custom object that implements IFormatProvider.

Wenn provider ist null oder NumberFormatInfo Objekt kann nicht abgerufen werden, von provider, der Rückgabewert formatiert wird, mit der NumberFormatInfo -Objekt für die aktuelle Threadkultur.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Informationen über die aktuelle Threadkultur, finden Sie unter Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Siehe auch

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameter

format
String String String String

Eine numerische Formatierungszeichenfolge.A numeric format string.

Gibt zurück

Die Zeichenfolgendarstellung des aktuellen Byte-Objekts im durch den format-Parameter angegebenen Format.The string representation of the current Byte object, formatted as specified by the format parameter.

Ausnahmen

format enthält einen nicht unterstützten Spezifizierer.format includes an unsupported specifier. Unterstützte Formatspezifizierer sind im Abschnitt "Hinweise" aufgeführt.Supported format specifiers are listed in the Remarks section.

Beispiele

Im folgenden Beispiel initialisiert einen Byte Wert ein, und zeigt sie an die Konsole, indem Sie die unterstützen Standardformatzeichenfolgen und eine benutzerdefinierte Formatzeichenfolge.The following example initializes a Byte value and displays it to the console using each of the supported standard format strings and a custom format string. Im Beispiel wird mit En-US als aktuelle Kultur ausgeführt.The example is run with en-US as the current culture.

array<String^>^ formats = gcnew array<String^> {"C3", "D4", "e1", "E2", "F1", "G", "N1", 
                                                "P0", "X4", "0000.0000"};
Byte number = 240;
for each (String^ format in formats)
   Console::WriteLine("'{0}' format specifier: {1}", 
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000           
string[] formats = {"C3", "D4", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "0000.0000"};
byte number = 240;
foreach (string format in formats)
   Console.WriteLine("'{0}' format specifier: {1}", 
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000           
Dim formats() As String = {"C3", "D4", "e1", "E2", "F1", "G", _
                           "N1", "P0", "X4", "0000.0000"}
Dim number As Byte = 240
For Each format As String In formats
   Console.WriteLine("'{0}' format specifier: {1}", _
                     format, number.ToString(format))
Next  
' The example displays the following output to the console if the
' current culture is en-us:
'       'C3' format specifier: $240.000
'       'D4' format specifier: 0240
'       'e1' format specifier: 2.4e+002
'       'E2' format specifier: 2.40E+002
'       'F1' format specifier: 240.0       
'       'G' format specifier: 240
'       'N1' format specifier: 240.0
'       'P0' format specifier: 24,000 %
'       'X4' format specifier: 00F0
'       '0000.0000' format specifier: 0240.0000           

Hinweise

Die format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Formatzeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle numerischen Standardformatzeichenfolgen als "R" (oder "R") werden unterstützt, da alle benutzerdefinierten numerischen Formatierungszeichen sind.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format ist null oder eine leere Zeichenfolge (""), die mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist.If format is null or an empty string (""), the return value is formatted with the general numeric format specifier ("G").

Der Rückgabewert dieser Funktion wird mit formatiert die NumberFormatInfo -Objekt für die aktuelle Threadkultur.The return value of this function is formatted using the NumberFormatInfo object for the thread current culture. Informationen über die aktuelle Threadkultur, finden Sie unter Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture. Aufrufen, um Formatierungsinformationen für Kulturen als der aktuellen Kultur zu ermöglichen, die Byte.ToString(String, IFormatProvider) Methode.To provide formatting information for cultures other than the current culture, call the Byte.ToString(String, IFormatProvider) method.

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Siehe auch

ToString() ToString() ToString() ToString()

Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the value of the current Byte object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieses Objekts, die aus einer Folge von Ziffern zwischen 0 und 9 ohne führende Nullen besteht.The string representation of the value of this object, which consists of a sequence of digits that range from 0 to 9 with no leading zeroes.

Beispiele

Das folgende Beispiel zeigt ein Array von Bytewerten.The following example displays an array of byte values. Beachten Sie, dass die ToString() Methode wird im Beispiel nicht explizit aufgerufen.Note that the ToString() method is not called explicitly in the example. Stattdessen, es wird implizit aufgerufen, durch die Verwendung von der kombinierte Formatierung Feature.Instead, it is called implicitly, because of the use of the composite formatting feature.

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
for each (Byte byteValue in bytes)
   Console::WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255
byte[] bytes = {0, 1, 14, 168, 255};
foreach (byte byteValue in bytes)
   Console.WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255
Dim bytes() As Byte = {0, 1, 14, 168, 255}
For Each byteValue As Byte In Bytes
   Console.WriteLine(byteValue)
Next   
' The example displays the following output to the console if the current
' culture is en-US:
'       0
'       1
'       14
'       168
'       255      

Hinweise

Der Rückgabewert mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist und die NumberFormatInfo -Objekt für die aktuelle Threadkultur.The return value is formatted with the general numeric format specifier ("G") and the NumberFormatInfo object for the thread current culture. Definieren Sie die Formatierung von der Byte Zeichenfolgendarstellung des Werts, rufen die ToString Methode.To define the formatting of the Byte value's string representation, call the ToString method. Zum Definieren der Formatbezeichner und die Kultur, die zum Erstellen der Zeichenfolgendarstellung einer Byte Wert, rufen Sie die ToString Methode.To define both the format specifiers and culture used to create the string representation of a Byte value, call the ToString method.

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Informationen über die aktuelle Threadkultur, finden Sie unter Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

Gilt für: