Freigeben über


Byte.ToString Methode

Definition

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

Überlädt

ToString(IFormatProvider)

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

ToString(String)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.

ToString(String, IFormatProvider)

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats sowie der kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

ToString()

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

ToString(IFormatProvider)

Quelle:
Byte.cs
Quelle:
Byte.cs
Quelle:
Byte.cs

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

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
 System::String ^ ToString(IFormatProvider ^ provider);
public 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

Die Zeichenfolgendarstellung des Werts dieses Objekts in dem vom provider-Parameter angegebenen Format.

Implementiert

Beispiele

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

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)
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 über das Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird. Das Objekt, das implementiert IFormatProvider , kann eines 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.

Wenn provider ist null oder ein NumberFormatInfo Objekt nicht aus providerabgerufen werden 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

Gilt für:

ToString(String)

Quelle:
Byte.cs
Quelle:
Byte.cs
Quelle:
Byte.cs

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (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.

Gibt zurück

Die Zeichenfolgendarstellung des aktuellen Byte-Objekts im durch den format-Parameter angegebenen Format.

Ausnahmen

format enthält einen nicht unterstützten Spezifizierer. Unterstützte Formatspezifizierer sind im Abschnitt "Hinweise" aufgeführt.

Beispiele

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

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
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 numerische Formatzeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format oder eine leere Zeichenfolge ("") ist null , 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 -Methode auf, um Formatierungsinformationen für andere Kulturen als die Byte.ToString(String, IFormatProvider) aktuelle Kultur bereitzustellen.

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

Weitere Informationen

Gilt für:

ToString(String, IFormatProvider)

Quelle:
Byte.cs
Quelle:
Byte.cs
Quelle:
Byte.cs

Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats sowie der kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (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.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

Die Zeichenfolgendarstellung des aktuellen Byte-Objekts im durch die format- und provider-Parameter angegebenen Format.

Implementiert

Ausnahmen

format enthält einen nicht unterstützten Spezifizierer. Unterstützte Formatspezifizierer sind im Abschnitt "Hinweise" aufgeführt.

Beispiele

Im folgenden Beispiel werden die Standardformatzeichenfolge "N" und vier verschiedene CultureInfo Objekte verwendet, um die Zeichenfolgendarstellung eines Bytewerts in der Konsole anzuzeigen.

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)
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. Um eine Zahl mit dem Standardformat ("G") der aktuellen Kultur zu formatieren, rufen Sie die -Methode auf ToString() . Um eine Zahl mit einem angegebenen Format der aktuellen Kultur zu formatieren, rufen Sie die ToString(String) -Methode auf.

Der format Parameter kann entweder eine Standard- oder eine benutzerdefinierte numerische Formatzeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format oder eine leere Zeichenfolge ("") ist null , wird der Rückgabewert dieser Methode 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 über das Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird. Das Objekt, das implementiert IFormatProvider , kann eines 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.

Wenn provider ist null oder ein NumberFormatInfo Objekt nicht aus providerabgerufen werden 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

Gilt für:

ToString()

Quelle:
Byte.cs
Quelle:
Byte.cs
Quelle:
Byte.cs

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

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

Beispiele

Im folgenden Beispiel wird ein Array von Bytewerten angezeigt. Beachten Sie, dass die ToString() -Methode im Beispiel nicht explizit aufgerufen wird. Stattdessen wird es implizit aufgerufen, da das F#-Beispiel die Zeichenfolgeninterpolation verwendet, da die zusammengesetzte Formatierungsfunktion verwendet wird.

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
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 auf, um die ToString Formatierung der Byte Zeichenfolgendarstellung des Werts zu definieren. Rufen Sie die -Methode auf, um sowohl die Formatbezeichner als auch die ToString 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:

Informationen zur aktuellen Threadkultur finden Sie unter Thread.CurrentCulture.

Gilt für: