Byte.ToString Methode

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)

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)

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)

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()

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)

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:
 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

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 Byte Werten durchlaufen und jede der Konsolen angezeigt, indem die ToString(IFormatProvider) -Methode mit unterschiedlichen Format Anbietern aufgerufen wird.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 Rückgabewert ist mit dem allgemeinen numerischen Format Bezeichner ("G") formatiert.The return value is formatted with the general numeric format specifier ("G").

Der provider -Parameter ist ein Objekt, das IFormatProvider die-Schnittstelle implementiert.The provider parameter is an object that implements the IFormatProvider interface. Die GetFormat zugehörige- NumberFormatInfo Methode gibt ein-Objekt zurück, das kulturspezifische Informationen über das Format der Zeichenfolge bereitstellt, 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 IFormatProvider implementiert, kann eines der folgenden sein:The object that implements IFormatProvider can be any of the following:

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

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

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

provider NumberFormatInfo providerWenn den Wert hat NumberFormatInfo oder ein-Objekt nicht aus abgerufen werden kann, wird der Rückgabewert mit dem-Objekt für die aktuelle Thread Kultur formatiert. nullIf 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. Weitere Informationen zur aktuellen Thread Kultur finden Thread.CurrentCultureSie unter.For information about the thread current culture, see Thread.CurrentCulture.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen 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)

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

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

provider
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 werden die Standardformat Zeichenfolge "N" und CultureInfo vier verschiedene-Objekte verwendet, um die Zeichen folgen Darstellung eines Bytewerts in der Konsole anzuzeigen.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 Standardformat ("G") der aktuellen Kultur zu formatieren, müssen Sie ToString() die-Methode aufzurufen.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 der aktuellen Kultur zu formatieren, müssen Sie ToString(String) die-Methode aufzurufen.To format a number by using a specified format of the current culture, call the ToString(String) method.

Der format -Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Format Zeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle standardmäßigen Zahlenformat Zeichenfolgen außer "r" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten Zahlen Formatierungszeichen.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format oder null eine leere Zeichenfolge ("") ist, wird der Rückgabewert dieser Methode mit dem allgemeinen numerischen Format Bezeichner ("G") formatiert.If format is null or an empty string (""), the return value of this method is formatted with the general numeric format specifier ("G").

Der provider -Parameter ist ein Objekt, das IFormatProvider die-Schnittstelle implementiert.The provider parameter is an object that implements the IFormatProvider interface. Die GetFormat zugehörige- NumberFormatInfo Methode gibt ein-Objekt zurück, das kulturspezifische Informationen über das Format der Zeichenfolge bereitstellt, 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 IFormatProvider implementiert, kann eines der folgenden sein:The object that implements IFormatProvider can be any of the following:

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

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

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

provider NumberFormatInfo providerWenn den Wert hat NumberFormatInfo oder ein-Objekt nicht aus abgerufen werden kann, wird der Rückgabewert mit dem-Objekt für die aktuelle Thread Kultur formatiert. nullIf 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. Weitere Informationen zur aktuellen Thread Kultur finden Thread.CurrentCultureSie unter.For information about the thread current culture, see Thread.CurrentCulture.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen 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)

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

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 wird ein Byte Wert initialisiert und in der Konsole angezeigt, wobei jede der unterstützten Standardformat Zeichenfolgen und eine benutzerdefinierte Format Zeichenfolge verwendet wird.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. Das 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

Der format -Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Format Zeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle standardmäßigen Zahlenformat Zeichenfolgen außer "r" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten Zahlen Formatierungszeichen.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format oder null eine leere Zeichenfolge ("") ist, wird der Rückgabewert mit dem allgemeinen numerischen Formatspezifizierer ("G") formatiert.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 dem NumberFormatInfo -Objekt für die aktuelle Thread Kultur formatiert.The return value of this function is formatted using the NumberFormatInfo object for the thread current culture. Weitere Informationen zur aktuellen Thread Kultur finden Thread.CurrentCultureSie unter.For information about the thread current culture, see Thread.CurrentCulture. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, Byte.ToString(String, IFormatProvider) müssen Sie die-Methode aufzurufen.To provide formatting information for cultures other than the current culture, call the Byte.ToString(String, IFormatProvider) method.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen 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()

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

Im folgenden Beispiel wird ein Array von Byte Werten angezeigt.The following example displays an array of byte values. Beachten Sie, ToString() dass die-Methode im Beispiel nicht explizit aufgerufen wird.Note that the ToString() method is not called explicitly in the example. Stattdessen wird Sie implizit aufgerufen, weil das Feature für die kombinierte Formatierung verwendet wird.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 wird mit dem allgemeinen numerischen Format Bezeichner ("G") und dem NumberFormatInfo -Objekt für die aktuelle Thread Kultur formatiert.The return value is formatted with the general numeric format specifier ("G") and the NumberFormatInfo object for the thread current culture. Um die Formatierung Byte der Zeichen folgen Darstellung des Werts zu definieren, müssen ToString Sie die-Methode aufzurufen.To define the formatting of the Byte value's string representation, call the ToString method. Rufen Sie die ToString -Methode auf, um die Format Bearbeiter und die Kultur zu definieren Byte , die zum Erstellen der Zeichen folgen Darstellung eines Werts verwendet werden.To define both the format specifiers and culture used to create the string representation of a Byte value, call the ToString method.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Weitere Informationen zur aktuellen Thread Kultur finden Thread.CurrentCultureSie unter.For information about the thread current culture, see Thread.CurrentCulture.

Gilt für: