Byte.ToString Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

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

Přetížení

Name	Description
ToString()	Převede hodnotu aktuálního Byte objektu na ekvivalentní řetězcové vyjádření.
ToString(IFormatProvider)	Převede číselnou hodnotu aktuálního Byte objektu na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátování specifické pro jazykovou verzi.
ToString(String)	Převede hodnotu aktuálního Byte objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu.
ToString(String, IFormatProvider)	Převede hodnotu aktuálního Byte objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátování specifické pro jazykovou verzi.

ToString()

Zdroj:

Byte.cs

Převede hodnotu aktuálního Byte objektu na 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 počátečních nul.

Příklady

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

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

Návratová hodnota je formátována pomocí obecného specifikátoru číselného formátu ("G") a NumberFormatInfo objektu pro aktuální jazykovou verzi vlákna. Chcete-li definovat formátování řetězcové Byte reprezentace hodnoty, zavolejte metodu ToString . Chcete-li definovat specifikátory formátu i jazykovou verzi použitou k vytvoření řetězcové Byte reprezentace hodnoty, zavolejte metodu ToString .

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

• Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování naleznete v tématu Typy formátování.

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

ToString(IFormatProvider)

Zdroj:

Byte.cs

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

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

Parametry

provider

IFormatProvider

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

Návraty

String

Řetězcové vyjádření hodnoty tohoto objektu ve formátu určeném parametrem provider .

Implementuje

ToString(IFormatProvider)

Příklady

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

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

Návratová hodnota je naformátovaná specifikátorem obecného číselného formátu ("G").

Parametr provider je objekt, který implementuje IFormatProvider rozhraní. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce, který je vrácen touto metodou. Objekt, který implementuje 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 provider je null nebo NumberFormatInfo objekt nelze získat z provider, návratová hodnota je naformátována pomocí NumberFormatInfo objektu pro aktuální jazykovou verzi vlákna. Informace o aktuální jazykové verzi vlákna naleznete v tématu Thread.CurrentCulture.

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

• Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování naleznete v tématu Typy formátování.

Viz také

• Parse(String)
• String
• NumberFormatInfo
• Typy formátování v .NET

ToString(String)

Zdroj:

Byte.cs

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

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

Parametry

format

String

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

Návraty

String

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

Výjimky

FormatException

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

Příklady

Následující příklad inicializuje Byte hodnotu a zobrazí ji v konzole pomocí každého z podporovaných standardních formátových řetězců a vlastní formátovací řetězec. Příklad se spustí s en-US jako aktuální jazykovou verzí.

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. Podporují se všechny standardní řetězce číselného formátu kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu. Pokud format je nebo je null prázdný řetězec (""), návratová hodnota je naformátovaná specifikátorem obecného číselného formátu ("G").

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

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

• Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování naleznete v tématu Typy formátování.

Viz také

• Postupy: Nastavení čísla s počátečními nulami

ToString(String, IFormatProvider)

Zdroj:

Byte.cs

Převede hodnotu aktuálního Byte objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátování specifické pro jazykovou verzi.

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

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 parametrů.

Implementuje

ToString(String, IFormatProvider)

Výjimky

FormatException

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í řetězec formátu "N" a čtyři různé CultureInfo objekty k zobrazení řetězcové reprezentace bajtové hodnoty konzoly.

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. Chcete-li formátovat číslo pomocí výchozího formátu ("G") aktuální jazykové verze, zavolejte metodu ToString() . Chcete-li formátovat číslo pomocí zadaného formátu aktuální jazykové verze, zavolejte metodu ToString(String) .

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

Parametr provider je objekt, který implementuje IFormatProvider rozhraní. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce, který je vrácen touto metodou. Objekt, který implementuje 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 provider je null nebo NumberFormatInfo objekt nelze získat z provider, návratová hodnota je naformátována pomocí NumberFormatInfo objektu pro aktuální jazykovou verzi vlákna. Informace o aktuální jazykové verzi vlákna naleznete v tématu Thread.CurrentCulture.

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

• Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování naleznete v tématu Typy formátování.

Viz také

• Parse(String)
• String
• NumberFormatInfo
• IFormattable
• IFormatProvider
• Typy formátování v .NET
• Postupy: Nastavení čísla s počátečními nulami
• Ukázka : rozhraní .NET Core WinForms (C#)
• ukázka : .NET Core WinForms Formatting Utility (Visual Basic)