Int64.ToString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.
Перегрузки
ToString(IFormatProvider) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанные сведения о формате, зависящее от языка и региональных параметров. |
ToString() |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление. |
ToString(String) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат. |
ToString(String, IFormatProvider) |
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление, используя указанный формат и сведения о формате, зависящее от языка и региональных параметров. |
ToString(IFormatProvider)
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.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
IFormatProvider, предоставляющий сведения о форматировании, зависящие от языка и региональных параметров.
Возвращаемое значение
Строковое представление значения этого экземпляра, указанного provider
.
Реализации
Примеры
В следующем примере отображается строковое представление значения Int64 с помощью объектов CultureInfo, представляющих несколько различных языков и региональных параметров.
long value = -16325901;
// 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:
// -16325901
// -16325901
// -16325901
let value = -16325901L
// 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:
// -16325901
// -16325901
// -16325901
Dim value As Long = -16325801
' 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:
' -16325901
' -16325901
' -16325901
Комментарии
Метод ToString(IFormatProvider) форматирует значение Int64 в формате по умолчанию ("G" или общего) с помощью объекта NumberFormatInfo указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Язык и региональные параметры по умолчанию (current) | ToString() |
Определенный формат | Язык и региональные параметры по умолчанию (current) | ToString(String) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
Параметр provider
— это объект, реализующий интерфейс IFormatProvider. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о формате строки, возвращаемой этим методом. Объект, реализующий IFormatProvider, может быть любым из следующих элементов:
Объект CultureInfo, представляющий язык и региональные параметры, правила форматирования которых необходимо использовать.
Объект NumberFormatInfo, содержащий определенные числовые сведения о форматировании этого значения.
Настраиваемый объект, реализующий IFormatProvider и метод GetFormat которого возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.
Если provider
null
или объект NumberFormatInfo не может быть получен из provider
, возвращаемое значение отформатировано с помощью объекта NumberFormatInfo для текущего языка и региональных параметров.
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
См. также раздел
- Parse(String)
- String
- Типы форматирования в .NET
Применяется к
ToString()
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.cs
Преобразует числовое значение этого экземпляра в эквивалентное строковое представление.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Возвращаемое значение
Строковое представление значения этого экземпляра, состоящее из знака минуса, если значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без начальных нулей.
Примеры
В следующем примере отображается значение Int64 с помощью метода ToString() по умолчанию. В нем также отображаются строковые представления значения Int64, которое приводит к использованию ряда стандартных описателей формата. Примеры отображаются с помощью соглашений о форматировании языка и региональных параметров en-US.
long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -16325091
Console.WriteLine(value.ToString("C")); // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")); // Displays -16325091
Console.WriteLine(value.ToString("F")); // Displays -16325091.00
Console.WriteLine(value.ToString("N")); // Displays -16,325,091.00
Console.WriteLine(value.ToString("N0")); // Displays -16,325,091
Console.WriteLine(value.ToString("X")); // Displays FFFFFFFFFF06E61D
let value = -16325091L
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -16325091
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -16325091
printfn $"""{value.ToString "C"}""" // Displays ($16,325,091.00)
printfn $"""{value.ToString "D"}""" // Displays -16325091
printfn $"""{value.ToString "F"}""" // Displays -16325091.00
printfn $"""{value.ToString "N"}""" // Displays -16,325,091.00
printfn $"""{value.ToString "N0"}""" // Displays -16,325,091
printfn $"""{value.ToString "X"}""" // Displays FFFFFFFFFF06E61D
Dim value As Long = -16325091
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -16325091
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -16325091
Console.WriteLine(value.ToString("C")) ' Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")) ' Displays -16325091
Console.WriteLine(value.ToString("F")) ' Displays -16325091.00
Console.WriteLine(value.ToString("N")) ' Displays -16,325091.00
Console.WriteLine(value.ToString("X")) ' Displays FFFFFFFFFF06E61D
Комментарии
Метод ToString() форматирует значение Int64 в формате по умолчанию ("G" или "общие") с помощью объекта NumberFormatInfo текущего языка и региональных параметров. Если вы хотите указать другой формат или региональные параметры, используйте другие перегрузки метода ToString следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Определенный язык и региональные параметры | ToString(IFormatProvider) |
Определенный формат | Язык и региональные параметры по умолчанию (current) | ToString(String) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
См. также раздел
- Parse(String)
- String
- Типы форматирования в .NET
Применяется к
ToString(String)
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.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
недопустимо или не поддерживается.
Примеры
В следующем примере отображается значение Int64 с помощью каждого из поддерживаемых описателей стандартного числового формата вместе с двумя настраиваемыми строками числовых форматов. При преобразовании числовых значений в строки пример использует соглашения о форматировании языка и региональных параметров en-US.
long 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.0).ToString(specifier));
// Displays: P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: X: FFFFFFFFFFFFC03B
// 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 = -16325L
// 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}: {(float value / 100000.0).ToString specifier}"
// Displays: P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays: X: FFFFFFFFFFFFC03B
// 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 * -1L).ToString specifier}"
// Displays: #,#.00#(#,#.00#): 16,325.00
Dim value As Long = -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: FFFFFFFFFFFFC03B
' 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) форматирует значение Int64 в указанном формате с помощью объекта NumberFormatInfo, представляющего соглашения текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию (G или общие) или указать другой язык и региональные параметры, используйте другие перегрузки метода ToString следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Язык и региональные параметры по умолчанию (current) | ToString() |
Формат по умолчанию ("G") | Определенный язык и региональные параметры | ToString(IFormatProvider) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
Параметр format
может быть любым допустимым описатель стандартного числового формата, кроме R, а также любого сочетания настраиваемых описателей числовых форматов. Если format
null
или пустая строка (""), возвращаемое значение этого экземпляра отформатировано общим числовым описателем ("G").
.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:
Дополнительные сведения об описателях числовых форматов строк стандартного числового формата и пользовательских строк числовых форматов.
Дополнительные сведения о форматировании см. в типов форматирования.
Возвращаемое значение этого экземпляра отформатировано NumberFormatInfo для текущего языка и региональных параметров.
См. также раздел
- Parse(String)
- String
- Типы форматирования в .NET
- строк стандартного числового формата
- пользовательских строк числовых форматов
- How to: Pad a Number with Leading Zeros
Применяется к
ToString(String, IFormatProvider)
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.cs
- Исходный код:
- Int64.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") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "N0", "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 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
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// 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 FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
// 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 = 1679L
let negativeNumber = -3045L
let specifiers = [| "G"; "C"; "D8"; "E2"; "F"; "N"; "N0"; "P"; "X8" |]
for specifier in specifiers do
for culture in cultures do
// Display values with "G" format specifier.
printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// 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
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// 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 FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
' 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 Long = 1679
Dim negativeNumber As Long = -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 FFFFFFFFFFFFF41B
' X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
' X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
Комментарии
Метод ToString(String, IFormatProvider) форматирует значение Int64 в указанном формате с помощью объекта 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
- строк стандартного числового формата
- пользовательских строк числовых форматов
- How to: Pad a Number with Leading Zeros
- пример: служебная программа форматирования WinForms .NET Core (C#)
- пример : служебная программа форматирования WinForms .NET Core (Visual Basic)