Byte.ToString Methode

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.

Überlädt

Name	Beschreibung
ToString(IFormatProvider)	Konvertiert den numerischen Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen kulturspezifischen Formatierungsinformationen.
ToString(String, IFormatProvider)	Konvertiert den Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen Format- und kulturspezifischen Formatierungsinformationen.
ToString(String)	Konvertiert den Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe des angegebenen Formats.
ToString()	Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.

ToString(IFormatProvider)

Konvertiert den numerischen Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen kulturspezifischen Formatierungsinformationen.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

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.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieses Objekts im durch den provider Parameter angegebenen Format.

Implementiert

ToString(IFormatProvider)

Beispiele

Im folgenden Beispiel wird ein Array von Bytewerten durchlaufen und jede dieser Werte in der Konsole angezeigt, indem die ToString(IFormatProvider) Methode mit verschiedenen Formatanbietern aufgerufen wird.

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)

let bytes = [| 0; 1; 14; 168; 255 |]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for byteValue in bytes do
    for provider in providers do
        printf $"{byteValue.ToString provider,3} ({provider.Name})      " 

    printfn ""

// 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 wird mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.

Der provider Parameter ist ein Objekt, das die IFormatProvider Schnittstelle implementiert. Die GetFormat Methode gibt ein NumberFormatInfo Objekt zurück, das kulturspezifische Informationen zum Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird. Das implementierte IFormatProvider Objekt kann eine der folgenden Sein:

Ein CultureInfo Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.
Ein NumberFormatInfo Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.
Ein benutzerdefiniertes IFormatProviderObjekt, das implementiert wird.

Wenn provider ein null Objekt nicht NumberFormatInfo abgerufen providerwerden kann, wird der Rückgabewert mithilfe des NumberFormatInfo Objekts für die aktuelle Threadkultur formatiert. Informationen zur aktuellen Threadkultur finden Sie unter Thread.CurrentCulture.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
Weitere Informationen zur Formatierung finden Sie unter "Formatierungstypen".

Weitere Informationen

Gilt für:

ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen Format- und kulturspezifischen Formatierungsinformationen.

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 standard- oder benutzerdefinierte zahlenformatige Zeichenfolge.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen Byte Objekts, formatiert gemäß den Angaben und formatprovider Parametern.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

format enthält einen nicht unterstützten Bezeichner. Unterstützte Formatbezeichner werden im Abschnitt "Hinweise" aufgeführt.

Beispiele

Im folgenden Beispiel wird die standardmäßige N-Formatzeichenfolge und vier verschiedene CultureInfo Objekte verwendet, um die Zeichenfolgendarstellung eines Bytewerts auf der Konsole anzuzeigen.

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)

let byteValue = 250uy
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "es-es"
      CultureInfo "de-de" ]

for provider in providers do
    printfn $"""{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. Rufen Sie die ToString() Methode auf, um eine Zahl mithilfe des Standardformats ("G") der aktuellen Kultur zu formatieren. Rufen Sie die ToString(String) Methode auf, um eine Zahl mithilfe eines angegebenen Formats der aktuellen Kultur zu formatieren.

Der format Parameter kann entweder eine Standard- oder eine benutzerdefinierte zahlenformatige Zeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format es null sich um eine leere Zeichenfolge ("") handelt, wird der Rückgabewert dieser Methode mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.

Ein CultureInfo Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.
Ein NumberFormatInfo Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.
Ein benutzerdefiniertes IFormatProviderObjekt, das implementiert wird.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
Weitere Informationen zur Formatierung finden Sie unter "Formatierungstypen".

Weitere Informationen

Gilt für:

ToString(String)

Konvertiert den Wert des aktuellen Byte Objekts in die entsprechende Zeichenfolgendarstellung mithilfe des angegebenen Formats.

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 Formatzeichenfolge.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen Byte Objekts, formatiert durch den format Parameter.

Ausnahmen

FormatException

format enthält einen nicht unterstützten Bezeichner. Unterstützte Formatbezeichner werden im Abschnitt "Hinweise" aufgeführt.

Beispiele

Im folgenden Beispiel wird ein Byte Wert initialisiert und mithilfe der unterstützten Standardformatzeichenfolgen und einer benutzerdefinierten Formatzeichenfolge in der Konsole angezeigt. Das Beispiel wird mit en-US als aktuelle Kultur ausgeführt.

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

let formats = 
    [ "C3"; "D4"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "0000.0000" ]
let number = 240uy
for format in formats do
    printfn $"'{format}' format specifier: {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 Standard- oder eine benutzerdefinierte zahlenformatige Zeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format es null sich um eine leere Zeichenfolge ("") handelt, wird der Rückgabewert mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.

Der Rückgabewert dieser Funktion wird mithilfe des NumberFormatInfo Objekts für die aktuelle Threadkultur formatiert. Informationen zur aktuellen Threadkultur finden Sie unter Thread.CurrentCulture. Rufen Sie die Byte.ToString(String, IFormatProvider) Methode auf, um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
Weitere Informationen zur Formatierung finden Sie unter "Formatierungstypen".

Weitere Informationen

Gewusst wie: Auffüllen einer Zahl mit führenden Nullen

Gilt für:

ToString()

Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung.

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieses Objekts, das aus einer Sequenz von Ziffern besteht, die zwischen 0 und 9 liegen, ohne führende Nullen.

Beispiele

Im folgenden Beispiel wird ein Array von Bytewerten angezeigt. Beachten Sie, dass die ToString() Methode im Beispiel nicht explizit aufgerufen wird. Stattdessen wird sie implizit aufgerufen, aufgrund der Verwendung des Zusammengesetztformatierungsfeatures verwendet das F#-Beispiel die Zeichenfolgeninterpolation.

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

let bytes = [| 0; 1; 14; 168; 255 |]
for byteValue in bytes do
    printfn $"{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 Formatbezeichner ("G") und dem NumberFormatInfo Objekt für die aktuelle Threadkultur formatiert. Rufen Sie die Methode aufToString, um die Formatierung der Zeichenfolgendarstellung des Byte Werts zu definieren. Rufen Sie die Methode aufToString, um sowohl die Formatbezeichner als auch die Kultur zu definieren, die zum Erstellen der Zeichenfolgendarstellung eines Byte Werts verwendet wird.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
Weitere Informationen zur Formatierung finden Sie unter "Formatierungstypen".

Informationen zur aktuellen Threadkultur finden Sie unter Thread.CurrentCulture.

Gilt für:

Feedback

War diese Seite hilfreich?