Byte.ToString Metoda

Definice

Převede hodnotu aktuálního objektu na jeho Byte ekvivalentní řetězcové vyjádření.

Přetížení

ToString(IFormatProvider)

Převede číselnou hodnotu aktuálního objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaných informací o formátování Byte specifických pro jazykovou verzi.

ToString(String, IFormatProvider)

Převede hodnotu aktuálního objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátování Byte specifických pro jazykovou verzi.

ToString(String)

Převede hodnotu aktuálního objektu na jeho ekvivalentní Byte řetězcové vyjádření pomocí zadaného formátu.

ToString()

Převede hodnotu aktuálního objektu na jeho Byte ekvivalentní řetězcové vyjádření.

ToString(IFormatProvider)

Převede číselnou hodnotu aktuálního objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaných informací o formátování Byte specifických pro jazykovou verzi.

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

Parametry

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcová reprezentace hodnoty tohoto objektu ve formátu určeném provider parametrem .

Implementuje

Příklady

Následující příklad iteruje pole hodnot bajtů a zobrazí každý z nich v konzole voláním metody s ToString(IFormatProvider) různými poskytovateli formátu.

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)

Poznámky

Vrácená hodnota je formátována pomocí obecného specifikátoru číselného formátu ("G").

Parametr provider je objekt, který implementuje IFormatProvider rozhraní . Jeho metoda vrátí objekt , který poskytuje informace specifické pro jazykovou verzi o formátu GetFormat NumberFormatInfo řetězce vráceného touto metodou. Implementuje objekt IFormatProvider může být některý z následujících:

  • Objekt, CultureInfo který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.

  • Objekt, NumberFormatInfo který obsahuje konkrétní informace o číselném formátování pro tuto hodnotu.

  • Vlastní objekt, který implementuje IFormatProvider .

Pokud je nebo objekt nelze získat z , je vrácená hodnota formátována provider pomocí objektu pro aktuální null NumberFormatInfo provider NumberFormatInfo jazykovou verzi vlákna. Informace o aktuální jazykové verzi vlákna najdete v tématu Thread.CurrentCulture .

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsaná v následujících tématech o formátování:

Viz také

Platí pro

ToString(String, IFormatProvider)

Převede hodnotu aktuálního objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátování Byte specifických pro jazykovou verzi.

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

Parametry

format
String

Standardní nebo vlastní řetězec číselného formátu.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcová reprezentace aktuálního Byte objektu formátovaná podle parametrů format a provider .

Implementuje

Výjimky

format obsahuje nepodporovaný specifikátor. Podporované specifikátory formátu jsou uvedeny v části Poznámky.

Příklady

Následující příklad používá standardní formátovací řetězec "N" a čtyři různé objekty k zobrazení řetězcové reprezentace hodnoty CultureInfo byte v konzole.

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)

Poznámky

Metoda ToString(String, IFormatProvider) formátuje Byte hodnotu v zadaném formátu zadané jazykové verze. Pokud chcete naformátovat číslo pomocí výchozího formátu ("G") aktuální jazykové verze, zavolejte ToString() metodu . Pokud chcete naformátovat číslo pomocí zadaného formátu aktuální jazykové verze, zavolejte ToString(String) metodu .

Parametr format může být standardní nebo vlastní řetězec číselného formátu. Jsou podporovány všechny standardní řetězce formátování čísel kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu. Pokud je nebo prázdný řetězec (""), návratová hodnota této metody je formátována pomocí obecného specifikátoru číselného formátu format null ("G").

Parametr provider je objekt, který implementuje IFormatProvider rozhraní . Jeho metoda vrátí objekt , který poskytuje informace specifické pro jazykovou verzi o formátu GetFormat NumberFormatInfo řetězce vráceného touto metodou. Implementuje objekt IFormatProvider může být některý z následujících:

  • Objekt, CultureInfo který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.

  • Objekt, NumberFormatInfo který obsahuje konkrétní informace o číselném formátování pro tuto hodnotu.

  • Vlastní objekt, který implementuje IFormatProvider .

Pokud je nebo objekt nelze získat z , je vrácená hodnota formátována provider pomocí objektu pro aktuální null NumberFormatInfo provider NumberFormatInfo jazykovou verzi vlákna. Informace o aktuální jazykové verzi vlákna najdete v tématu Thread.CurrentCulture .

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsaná v následujících tématech o formátování:

Viz také

Platí pro

ToString(String)

Převede hodnotu aktuálního objektu na jeho ekvivalentní Byte řetězcové vyjádření pomocí zadaného formátu.

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

Parametry

format
String

Řetězec číselného formátu.

Návraty

String

Řetězcová reprezentace aktuálního Byte objektu formátovaná podle format parametru .

Výjimky

format obsahuje nepodporovaný specifikátor. Podporované specifikátory formátu jsou uvedeny v části Poznámky.

Příklady

Následující příklad inicializuje hodnotu a zobrazí ji v konzole pomocí jednotlivých podporovaných řetězců standardního formátu Byte a vlastního formátovacího řetězce. Příklad se spustí s aktuální jazykovou verzí en-US.

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

Poznámky

Parametr format může být standardní nebo vlastní řetězec číselného formátu. Jsou podporovány všechny standardní řetězce formátování čísel kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu. Pokud je nebo prázdný řetězec (""), návratová hodnota je formátována pomocí obecného specifikátoru číselného formátu format null ("G").

Vrácená hodnota této funkce je formátována NumberFormatInfo pomocí objektu pro aktuální jazykovou verzi vlákna. Informace o aktuální jazykové verzi vlákna najdete v tématu Thread.CurrentCulture . Pokud chcete poskytnout informace o formátování pro jiné jazykové verze než aktuální jazykovou verzi, zavolejte Byte.ToString(String, IFormatProvider) metodu .

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsaná v následujících tématech o formátování:

Viz také

Platí pro

ToString()

Převede hodnotu aktuálního objektu na jeho Byte ekvivalentní řetězcové vyjádření.

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

Návraty

String

Řetězcová reprezentace hodnoty tohoto objektu, která se skládá z posloupnosti číslic v rozsahu od 0 do 9 bez úvodních nul.

Příklady

Následující příklad zobrazí pole hodnot bajtů. Všimněte ToString() si, že metoda není v příkladu explicitně volána. Místo toho se volá implicitně, protože se používá funkce složeného formátování, používá příklad jazyka F# interpolaci řetězců.

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

Poznámky

Vrácená hodnota je formátována pomocí obecného specifikátoru číselného formátu ("G") a objektu NumberFormatInfo pro aktuální jazykovou verzi vlákna. Pokud chcete definovat formátování řetězcové Byte reprezentace hodnoty, zavolejte ToString metodu . Pokud chcete definovat specifikátory formátu i jazykovou verzi, které se používají k vytvoření řetězcové reprezentace Byte hodnoty, zavolejte ToString metodu .

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsaná v následujících tématech o formátování:

Informace o aktuální jazykové verzi vlákna najdete v tématu Thread.CurrentCulture .

Platí pro