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

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


Int32.ToString Метод

Определение

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

Перегрузки

ToString(IFormatProvider)

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

ToString()

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

ToString(String)

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

ToString(String, IFormatProvider)

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

ToString(IFormatProvider)

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

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

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

Параметры

provider
IFormatProvider

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

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

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

Реализации

Примеры

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

C#
int value = -16325;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325
//       -16325
//       -16325

Комментарии

Метод ToString(IFormatProvider) форматирует значение Int32 в формате по умолчанию ("G" или общего) с помощью объекта NumberFormatInfo указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:

Использование формата Для языка и региональных параметров Использование перегрузки
Формат по умолчанию ("G") Язык и региональные параметры по умолчанию (current) ToString()
Определенный формат Язык и региональные параметры по умолчанию (current) ToString(String)
Определенный формат Определенный язык и региональные параметры ToString(String, IFormatProvider)

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

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

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

  • Настраиваемый объект, реализующий IFormatProvider и метод GetFormat которого возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.

Если providernull или объект 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()

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

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

C#
public override string ToString ();

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

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

Примеры

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

C#
int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B

Комментарии

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

Использование формата Для языка и региональных параметров Использование перегрузки
Формат по умолчанию ("G") Определенный язык и региональные параметры ToString(IFormatProvider)
Определенный формат Язык и региональные параметры по умолчанию (current) ToString(String)
Определенный формат Определенный язык и региональные параметры 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)

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

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

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

Параметры

format
String

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

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

Строковое представление значения этого экземпляра, указанного format.

Исключения

format недопустимо или не поддерживается.

Примеры

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

C#
int value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFC03B

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00

Комментарии

Метод ToString(String) форматирует значение Int32 в указанном формате с помощью объекта NumberFormatInfo, представляющего соглашения текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию (G или общие) или указать другой язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:

Использование формата Для языка и региональных параметров Использование перегрузки
Формат по умолчанию ("G") Язык и региональные параметры по умолчанию (current) ToString()
Формат по умолчанию ("G") Определенный язык и региональные параметры ToString(IFormatProvider)
Определенный формат Определенный язык и региональные параметры ToString(String, IFormatProvider)

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

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

Возвращаемое значение этого экземпляра отформатировано NumberFormatInfo для текущего языка и региональных параметров.

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

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

.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)

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

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

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

Параметры

format
String

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

provider
IFormatProvider

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

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

Строковое представление значения этого экземпляра, указанное format и provider.

Реализации

Исключения

format недопустимо или не поддерживается.

Примеры

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

C#
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"};

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
                        specifier, culture.Name,
                        positiveNumber.ToString(specifier, culture),
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

Комментарии

Метод ToString(String, IFormatProvider) форматирует значение Int32 в указанном формате с помощью объекта NumberFormatInfo заданного языка и региональных параметров. Если вы хотите использовать параметры формата по умолчанию или языка и региональных параметров, используйте другие перегрузки метода ToString следующим образом:

Использование формата Для языка и региональных параметров Использование перегрузки
Формат по умолчанию ("G") Язык и региональные параметры по умолчанию (current) ToString()
Формат по умолчанию ("G") Определенный язык и региональные параметры ToString(IFormatProvider)
Определенный формат Язык и региональные параметры по умолчанию (current) ToString(String)

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

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

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

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

  • Настраиваемый объект, реализующий IFormatProvider и метод GetFormat которого возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.

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

.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