Прочитать на английском

Поделиться через


Byte.ToString Метод

Определение

Преобразует значение текущего объекта Byte в эквивалентное ему строковое представление.

Перегрузки

ToString(IFormatProvider)

Преобразует числовое значение текущего объекта Byte в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.

ToString(String)

Преобразует значение текущего объекта Byte в эквивалентное ему строковое представление с использованием заданного формата.

ToString(String, IFormatProvider)

Преобразует числовое значение текущего объекта Byte в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

ToString()

Преобразует значение текущего объекта Byte в эквивалентное ему строковое представление.

ToString(IFormatProvider)

Исходный код:
Byte.cs
Исходный код:
Byte.cs
Исходный код:
Byte.cs

Преобразует числовое значение текущего объекта Byte в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.

C#
public string ToString (IFormatProvider provider);
C#
public string ToString (IFormatProvider? provider);

Параметры

provider
IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.

Возвращаемое значение

Строковое представление значения данного объекта в формате, заданном в параметре provider.

Реализации

Примеры

В следующем примере выполняется итерация массива байтовых значений и отображение каждого из них в консоли путем вызова ToString(IFormatProvider) метода с разными поставщиками формата.

C#
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)

Комментарии

Возвращаемое значение форматируется с помощью описателя общего числового формата ("G").

Параметр provider — это объект, реализующий IFormatProvider интерфейс . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Объект, реализующий , IFormatProvider может быть любым из следующих:

  • Объект CultureInfo , представляющий язык и региональные параметры, правила форматирования которых должны использоваться.

  • Объект NumberFormatInfo , содержащий определенные числовые сведения о форматировании для этого значения.

  • Пользовательский объект, реализующий IFormatProvider.

Если provider имеет значение null или NumberFormatInfo объект не может быть получен из provider, возвращаемое значение форматируется с помощью NumberFormatInfo объекта для текущего языка и региональных параметров потока. Сведения о текущем языке и региональных параметрах потока см. в разделе Thread.CurrentCulture.

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Исходный код:
Byte.cs
Исходный код:
Byte.cs
Исходный код:
Byte.cs

Преобразует значение текущего объекта Byte в эквивалентное ему строковое представление с использованием заданного формата.

C#
public string ToString (string format);
C#
public string ToString (string? format);

Параметры

format
String

Строка числового формата.

Возвращаемое значение

Строковое представление текущего объекта Byte, отформатированное, как указано в параметре format.

Исключения

format содержит неподдерживаемый спецификатор. Спецификаторы поддерживаемого формата перечислены в разделе "Примечания".

Примеры

В следующем примере значение инициализируется Byte и отображается в консоли с помощью каждой из поддерживаемых строк стандартного формата и строки настраиваемого формата. Пример выполняется с en-US в качестве текущего языка и региональных параметров.

C#
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

Комментарии

Параметр format может быть стандартной или пользовательской строкой числового формата. Поддерживаются все строки стандартного числового формата, отличные от "R" (или "r"), как и все символы настраиваемого числового формата. Если format имеет значение null или является пустой строкой (""), возвращаемое значение форматируется с помощью описателя общего числового формата ("G").

Возвращаемое значение этой функции отформатировано с помощью NumberFormatInfo объекта для текущего языка и региональных параметров потока. Сведения о текущем языке и региональных параметрах потока см. в разделе Thread.CurrentCulture. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего языка и региональных параметров, вызовите Byte.ToString(String, IFormatProvider) метод .

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Исходный код:
Byte.cs
Исходный код:
Byte.cs
Исходный код:
Byte.cs

Преобразует числовое значение текущего объекта Byte в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

C#
public string ToString (string format, IFormatProvider provider);
C#
public string ToString (string? format, IFormatProvider? provider);

Параметры

format
String

Стандартная или пользовательская строка числового формата.

provider
IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.

Возвращаемое значение

Строковое представление текущего объекта Byte, отформатированное, как указано в параметрах format и provider.

Реализации

Исключения

format содержит неподдерживаемый спецификатор. Спецификаторы поддерживаемого формата перечислены в разделе "Примечания".

Примеры

В следующем примере используется стандартная строка формата "N" и четыре различных CultureInfo объекта для отображения строкового представления байтового значения в консоли.

C#
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)

Комментарии

Метод ToString(String, IFormatProvider) форматирует Byte значение в указанном формате указанного языка и региональных параметров. Чтобы отформатировать число с использованием формата по умолчанию ("G") текущего языка и региональных параметров, вызовите ToString() метод . Чтобы отформатировать число с использованием указанного формата текущего языка и региональных параметров, вызовите ToString(String) метод .

Параметр format может быть стандартной или пользовательской строкой числового формата. Поддерживаются все строки стандартного числового формата, отличные от "R" (или "r"), как и все символы настраиваемого числового формата. Если format имеет значение null или является пустой строкой (""), возвращаемое значение этого метода форматируется с помощью общего описателя числового формата ("G").

Параметр provider — это объект, реализующий IFormatProvider интерфейс . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Объект, реализующий , IFormatProvider может быть любым из следующих:

  • Объект CultureInfo , представляющий язык и региональные параметры, правила форматирования которых должны использоваться.

  • Объект NumberFormatInfo , содержащий определенные числовые сведения о форматировании для этого значения.

  • Пользовательский объект, реализующий IFormatProvider.

Если provider имеет значение null или NumberFormatInfo объект не может быть получен из provider, возвращаемое значение форматируется с помощью NumberFormatInfo объекта для текущего языка и региональных параметров потока. Сведения о текущем языке и региональных параметрах потока см. в разделе Thread.CurrentCulture.

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString()

Исходный код:
Byte.cs
Исходный код:
Byte.cs
Исходный код:
Byte.cs

Преобразует значение текущего объекта Byte в эквивалентное ему строковое представление.

C#
public override string ToString ();

Возвращаемое значение

Строковое представление значения данного объекта, состоящее из последовательности цифр в диапазоне от 0 до 9 без начальных нулей.

Примеры

В следующем примере отображается массив байтовых значений. Обратите внимание, что ToString() в примере метод не вызывается явным образом. Вместо этого он вызывается неявно. Из-за использования функции составного форматирования в примере F# используется интерполяция строк.

C#
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

Комментарии

Возвращаемое значение форматируется с помощью описателя общего числового формата ("G") и объекта для текущего языка и NumberFormatInfo региональных параметров потока. Чтобы определить форматирование строкового Byte представления значения, вызовите ToString метод . Чтобы определить описатели формата и язык и региональные параметры, используемые для создания строкового Byte представления значения, вызовите ToString метод .

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

Сведения о текущем языке и региональных параметрах потока см. в разделе Thread.CurrentCulture.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0