Byte.ToString 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

将当前 Byte 对象的值转换为其等效的字符串表示形式。

重载

ToString(IFormatProvider)	使用指定的区域性特定格式设置信息将当前 Byte 对象的值转换为它的等效字符串表示形式。
ToString(String)	使用指定的格式将当前 Byte 对象的值转换为它的等效字符串表示形式。
ToString(String, IFormatProvider)	使用指定的格式和区域性特定格式信息将当前 Byte 对象的值转换为它的等效字符串表示形式。
ToString()	将当前 Byte 对象的值转换为其等效的字符串表示形式。

ToString(IFormatProvider)

Source:

Byte.cs

使用指定的区域性特定格式设置信息将当前 Byte 对象的值转换为它的等效字符串表示形式。

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

参数

provider

IFormatProvider

一个提供区域性特定的格式设置信息的对象。

返回

String

此对象值的字符串表示形式，采用 provider 参数所指定的格式。

实现

ToString(IFormatProvider)

示例

以下示例循环访问一个字节值数组，并通过使用不同的格式提供程序调用 ToString(IFormatProvider) 方法，将每个字节值显示到控制台。

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)

注解

返回值使用常规数值格式说明符 (“G”) 进行格式化。

参数 provider 是实现 接口的对象 IFormatProvider 。 其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关此方法返回的字符串格式的区域性特定信息。 实现 的对象 IFormatProvider 可以是以下任一项：

• 一个 CultureInfo 对象，表示要使用其格式规则的区域性。

• 一个 NumberFormatInfo 对象，其中包含此值的特定数值格式设置信息。

• 实现 的 IFormatProvider自定义对象。

如果 provider 无法从 provider获取 或 nullNumberFormatInfo 对象，则使用NumberFormatInfo线程当前区域性的 对象设置返回值的格式。 有关线程当前区域性的信息，请参阅 Thread.CurrentCulture。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

• 有关数值格式说明符的详细信息，请参阅 标准数值格式字符串 和 自定义数值格式字符串。

• 有关格式设置的详细信息，请参阅 格式设置类型。

另请参阅

• Parse(String)
• String
• NumberFormatInfo
• 设置 .NET 中类型的格式

ToString(String)

Source:

Byte.cs

使用指定的格式将当前 Byte 对象的值转换为它的等效字符串表示形式。

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

参数

format

String

一个数值格式字符串。

返回

String

按照 Byte 参数指定的方式进行格式设置的当前 format 对象的字符串表示形式。

例外

FormatException

format 包含不受支持的说明符。 “备注”部分中列出了受支持的格式说明符。

示例

以下示例使用每个支持的标准格式字符串和一个自定义格式字符串初始化一个 Byte 值并将其显示到控制台。 该示例以 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

注解

参数 format 可以是标准或自定义数字格式字符串。 支持除“R” (或“r”) 以外的所有标准数字格式字符串，以及所有自定义数字格式字符。 如果 format 为 null 或空字符串 (“”) ，则返回值使用常规数值格式说明符 (“G”) 进行格式设置。

此函数的返回值使用 NumberFormatInfo 线程当前区域性的 对象进行格式化。 有关线程当前区域性的信息，请参阅 Thread.CurrentCulture。 若要为当前区域性以外的区域性提供格式设置信息，请调用 Byte.ToString(String, IFormatProvider) 方法。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

• 有关数值格式说明符的详细信息，请参阅 标准数值格式字符串 和 自定义数值格式字符串。

• 有关格式设置的详细信息，请参阅 格式设置类型。

另请参阅

• 如何：用前导零填充数字

ToString(String, IFormatProvider)

Source:

Byte.cs

使用指定的格式和区域性特定格式信息将当前 Byte 对象的值转换为它的等效字符串表示形式。

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

参数

format

String

标准或自定义的数值格式字符串。

provider

IFormatProvider

一个提供区域性特定的格式设置信息的对象。

返回

String

按照 Byte 和 format 参数指定的方式进行格式设置的当前 provider 对象的字符串表示形式。

实现

ToString(String, IFormatProvider)

例外

FormatException

format 包含不受支持的说明符。 “备注”部分中列出了受支持的格式说明符。

示例

以下示例使用标准“N”格式字符串和四个不同的 CultureInfo 对象向控制台显示字节值的字符串表示形式。

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)

注解

方法 ToString(String, IFormatProvider) 以 Byte 指定区域性的指定格式设置值的格式。 若要使用当前区域性的默认 (“G”) 格式设置数字的格式，请调用 ToString() 方法。 若要使用当前区域性的指定格式设置数字的格式，请调用 ToString(String) 方法。

参数 format 可以是标准或自定义数字格式字符串。 支持除“R” (或“r”) 以外的所有标准数字格式字符串，以及所有自定义数字格式字符。 如果 format 为 null 或空字符串 (“”) ，则此方法的返回值使用常规数值格式说明符 (“G”) 进行格式化。

参数 provider 是实现 接口的对象 IFormatProvider 。 其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关此方法返回的字符串格式的区域性特定信息。 实现 的对象 IFormatProvider 可以是以下任一项：

• 一个 CultureInfo 对象，表示要使用其格式规则的区域性。

• 一个 NumberFormatInfo 对象，其中包含此值的特定数值格式设置信息。

• 实现 的 IFormatProvider自定义对象。

如果 provider 无法从 provider获取 或 nullNumberFormatInfo 对象，则使用NumberFormatInfo线程当前区域性的 对象设置返回值的格式。 有关线程当前区域性的信息，请参阅 Thread.CurrentCulture。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

• 有关数值格式说明符的详细信息，请参阅 标准数值格式字符串 和 自定义数值格式字符串。

• 有关格式设置的详细信息，请参阅 格式设置类型。

另请参阅

• Parse(String)
• String
• NumberFormatInfo
• IFormattable
• IFormatProvider
• 设置 .NET 中类型的格式
• 如何：用前导零填充数字
• 示例：.NET Core WinForms 格式设置实用工具 (C#)
• 示例：.NET Core WinForms 格式设置实用工具 (Visual Basic)

ToString()

Source:

Byte.cs

将当前 Byte 对象的值转换为其等效的字符串表示形式。

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

返回

String

此对象的值的字符串表示形式，由一系列从 0 到 9 之间的数字组成，不包含前导零。

示例

以下示例显示字节值的数组。 请注意， ToString() 在示例中未显式调用 方法。 相反，由于使用 复合格式设置 功能，F# 示例使用 字符串内插，因此会隐式调用它。

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

注解

使用常规数值格式说明符 (“G”) 和 NumberFormatInfo 线程当前区域性的对象设置返回值的格式。 若要定义值字符串表示形式的格式 Byte ，请调用 ToString 方法。 若要定义用于创建值的字符串表示形式 Byte 的格式说明符和区域性，请调用 ToString 方法。

.NET 提供广泛的格式设置支持，以下格式设置主题对此进行了更详细的介绍：

• 有关数值格式说明符的详细信息，请参阅 标准数值格式字符串 和 自定义数值格式字符串。

• 有关格式设置的详细信息，请参阅 格式设置类型。

有关线程当前区域性的信息，请参阅 Thread.CurrentCulture。