Int32.ToString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.
Перегрузки
| Имя | Описание |
|---|---|
| ToString(IFormatProvider) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанные сведения о формате, зависящее от языка и региональных параметров. |
| ToString() |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление. |
| ToString(String) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат. |
| ToString(String, IFormatProvider) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат и сведения о формате, зависящее от языка и региональных параметров. |
ToString(IFormatProvider)
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанные сведения о формате, зависящее от языка и региональных параметров.
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
Параметры
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.
Возвращаемое значение
Строковое представление значения этого экземпляра, указанного в параметре provider.
Реализации
Примеры
В следующем примере отображается строковое представление Int32 значения с помощью CultureInfo объектов, представляющих несколько различных языков и региональных параметров.
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
let value = -16325
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
// -16325
// -16325
// -16325
Dim value As Integer = -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 объект, предоставляющий сведения о форматировании.
Если provider объект nullNumberFormatInfo не может быть получен, providerвозвращаемое значение отформатировано с помощью NumberFormatInfo объекта для текущего языка и региональных параметров потока. Сведения о текущем языке и региональных параметрах потока см. в разделе Thread.CurrentCulture.
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
См. также раздел
Применяется к
ToString()
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.
public:
override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Возвращаемое значение
Строковое представление значения этого экземпляра, состоящее из отрицательного знака, если значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без начальных нулей.
Примеры
В следующем примере отображается Int32 значение с помощью метода по умолчанию ToString() . В нем также отображаются строковые Int32 представления значения, которое приводит к использованию ряда описателей стандартного формата. Примеры отображаются с помощью соглашений о форматировании языка и региональных параметров en-US.
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
let value = -16325
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -16325
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -16325
printfn $"""{value.ToString "C"}""" // Displays ($16,325.00)
printfn $"""{value.ToString "D"}""" // Displays -16325
printfn $"""{value.ToString "F"}""" // Displays -16325.00
printfn $"""{value.ToString "N"}""" // Displays -16,325.00
printfn $"""{value.ToString "X"}""" // Displays FFFFC03B
Dim value As Integer = -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 предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
См. также раздел
Применяется к
ToString(String)
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат.
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
Параметры
- format
- String
Строка стандартного или настраиваемого числового формата.
Возвращаемое значение
Строковое представление значения этого экземпляра, указанного в параметре format.
Исключения
format недопустим или не поддерживается.
Примеры
В следующем примере отображается Int32 значение с помощью каждого из поддерживаемых описателей стандартного числового формата вместе с двумя настраиваемыми строками числовых форматов. При преобразовании числовых значений в строки пример использует соглашения о форматировании языка и региональных параметров en-US.
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
let value = -16325
// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: G: -16325
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: C: ($16,325.00)
let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: D8: -00016325
let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: E4: -1.6325E+004
let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: e3: -1.633e+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: F: -16325.00
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: N: -16,325.00
let specifier = "P"
printfn $"{specifier}: {(value / 100000).ToString specifier}"
// Displays: P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: X: FFFFC03B
// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: 0,0.000: -16,325.000
let specifier = "#,#.00#;(#,#.00#)"
printfn $"{specifier}: {(value * -1).ToString specifier}"
// Displays: #,#.00#;(#,#.00#): 16,325.00
Dim value As Integer = -16325
Dim specifier As String
' 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, а также любого сочетания пользовательских описателей числовых форматов. Если format строка или null пустая строка (""), возвращаемое значение этого экземпляра отформатировано общим числовым описателем формата ("G").
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
Возвращаемое значение этого экземпляра отформатировано с NumberFormatInfo использованием текущего языка и региональных параметров.
См. также раздел
- Parse(String)
- String
- Типы форматирования в .NET
- Стандартные строки в числовом формате
- Настраиваемые числовые строковые форматы
- Практическое руководство. Заполнение числа с начальными нулями
Применяется к
ToString(String, IFormatProvider)
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
- Исходный код:
- Int32.cs
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат и сведения о формате, зависящее от языка и региональных параметров.
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
Параметры
- format
- String
Строка стандартного или настраиваемого числового формата.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.
Возвращаемое значение
Строковое представление значения этого экземпляра, указанного format и provider.
Реализации
Исключения
format недопустим или не поддерживается.
Примеры
В следующем примере отображается положительное и отрицательное значение с помощью каждого из поддерживаемых стандартных числовых описателей для трех разных языков и региональных параметров.
// 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
// Define cultures whose formatting conventions are to be used.
let cultures =
[ CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" ]
let positiveNumber = 1679
let negativeNumber = -3045
let specifiers = [ "G"; "C"; "D8"; "E2"; "F"; "N"; "P"; "X8" ]
for specifier in specifiers do
for culture in cultures do
// Display values format specifiers.
printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// 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
' Define cultures whose formatting conventions are to be used.
Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
CultureInfo.CreateSpecificCulture("fr-FR"), _
CultureInfo.CreateSpecificCulture("es-ES") }
Dim positiveNumber As Integer = 1679
Dim negativeNumber As Integer = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}
For Each specifier As String In specifiers
For Each culture As CultureInfo 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))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' 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"), как и все пользовательские числовые символы. Если format строка или null пустая строка (""), возвращаемое значение для этого экземпляра отформатировано с помощью общего числового описателя формата ("G").
Параметр provider — это объект, реализующий IFormatProvider интерфейс. Его GetFormat метод возвращает NumberFormatInfo объект, предоставляющий сведения о формате, определенном языком и региональными параметрами, о формате строки, возвращаемой этим методом. Объект, реализующий IFormatProvider , может быть любым из следующих элементов:
CultureInfo Объект, представляющий язык и региональные параметры, правила форматирования которых необходимо использовать.
Объект NumberFormatInfo , содержащий определенные числовые сведения о форматировании этого значения.
Настраиваемый объект, реализующий IFormatProvider и который GetFormat возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.
Если provider объект null не NumberFormatInfo может быть получен, providerвозвращаемое значение для этого экземпляра отформатировано с NumberFormatInfo использованием текущего языка и региональных параметров.
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
См. также раздел
- Parse(String)
- Типы форматирования в .NET
- Стандартные строки в числовом формате
- Настраиваемые числовые строковые форматы
- Практическое руководство. Заполнение числа с начальными нулями
- Пример: программа форматирования WinForms для .NET Core (C#)
- Пример: программа форматирования WinForms для .NET Core (Visual Basic)